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you won't believe it’s a dynamic 
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The Swap Meet for the Rest of You 
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Silicon Valley event called Computer Swap America. In fact, there’s one 
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This time, our back room walls are bulging—mainly because we 
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Editor’s Page 


by Sol Libes 


At the beginning of another year it is 
worthwhile to take a look at what we can 
expect to see in the way of the evolving 
marketplace. Will the dominance of the 
PC finally end, or are we in for another 
year of sameness? 


THE PC STANDARD 

There is no doubt that the last five years 
have seen the PC bus and PC/MS-DOS 
evolve into a standard. In some ways, this 
has been good; in other ways, not. The PC 
“standard” has made life easier for users 
who have to interface modems and print- 
ers and want to extend the capabilities of 
their systems. It has given software devel- 
opers a known system configuration that 
has allowed them to develop powerful soft- 
ware. And it has generated economies of 
scale that have brought costs down to a 
level that has put substantial computing 
power within the reach of millions. On the 
other hand, it has stiffled quite a bit of 
technological development. Many compa- 
nies who tried to innovate rather than copy 
are out of business; companies such as 
Morrow Designs, Otrona, Gavalin, 
Mindset, and Osborne are gone. Many 
others who remain have choosen to con- 
form rather than innovate. 

Even IBM, who typically closed out 
product lines every 3-4 years, was forced, 
by sheer market momentum, to keep the 
product in production much longer than it 
would have liked, giving competitors an 
opportunity to compete by copying. The 
question now is whether we will see a new 
standard come to the fore this year. 

There is no doubt that the PC/XT/AT 
has become a standard. Many companies 
are learning to innovate within the con- 
straints of the standard, though. Hard- 
ware innovations have included speeded- 
up processing, expanded memory 
addressing, expanded storage capability, 


improved graphics, and lower-cost net- 
working systems. Software innovations in- 
clude enhancements to the operating sys- 
tem, better user shells, and software that 
taxes the capabilities of the operating sys- 
tem. And, of course, the most important 
innovation is PC compatibility at signifi- 
cantly lower prices than IBM. 


A Look At The 
Year Ahead 


These enhancements have, to a great 
extent, put IBM in a catch-up position and 
hurt its competitive position in the market- 
place. Although many still buy their basic 
machine from IBM, they end up installing 
non-IBM hardware and software on these 
systems. There is no doubt that 1987 will 
see this trend continue. 

The basic PC/XT marketplace is now a 
commodity market. Purchasers look first 
for price, second for features, and third for 
support—just the opposite from the way 
IBM likes to sell to customers. 

IBM has been making threats of with- 
drawing from the low-end of the PC/XT 
marketplace. I doubt that it can afford to 
do this, though. Rather, I expect IBM to 
introduce a newer, lower-cost PC and XT 
tailored for entry-level users (e.g., schools) 
and with limited capabilities (e.g., as just 
word-processing systems or as basic work- 
stations). 


THE AT STANDARD 
The AT will almost certainly become the 
predominant standard in °87. Microsoft’s 
new version (5) of PC/MS-DOS should be- 
come available this year. It will be designed 
specifically for AT-compatible machines 
and provide features and capability not 
available on PC/XT systems. Software de- 
velopers can be expected to introduce soft- 
ware quickly for this new operating system 
and will abandon writing software for ear- 
lier versions. The PC/XT will soon become 
a dated system, much as CP/M is today, 
and its presence will gradually fade away. 
The second reason for the ascendance of 
the AT to the predominant position is cost. 
The prices of AT-class systems have 
dropped substantially, as clone compe- 
tition developed. The result is that the 
price differential between an XT and AT is 
no longer significant. For a little more 
money one gets a tremendous improve- 
ment in performance and capability. 
Although 386-based systems will be 
widely available in ’86, I think they will still 
not be a significant factor in the market- 
place. They would need the support of IBM, 
software support, and price competition to 
be so. I do not expect this to happen until 
1988 or 1989, at the earliest. The AT and 
DOS Version 5 should be the predominant 
system for 1987 and for much of 1988. 


THE DOS STANDARD 

DOS 5 will no doubt be the dominant op- 
erating system for the next year or two. 
XENIX and AT&T’s 6300-Plus, running 
UNIX, has failed to gain significant accep- 
tance. XENIX taxes the capabilities of the 
AT more than does DOS and leaves some- 
thing to be desired in performance. Add to 
that the added cost of running XENIX and 
lack of software support for same, and it is 
likely that XENIX will never rise above its 
current status in the market. 
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Digital Research’s Concurrent-DOS is 
without doubt superior to PC/MS-DOS, 
providing the multitasking features that 
Microsoft is just now getting around to in- 
corporating in PC/MS-DOS. And it has 
been available for about two years. But 
DRI has been slow to provide sufficient 
software compatibility and support for 
Concurrent-DOS to software developers. 
Although a number of systems houses are 
using it to build low-cost multiuser sys- 
tems, I do not expect that it will garner 
anything more than limited acceptance in 
the marketplace. 

Also, DRI’s GEM environment was 
available for more than a year before 
Microsoft’s Windows and in many ways is 
still a better performer. But here again, 
DRI has not supported its product or pro- 
moted it. There is still a question as to 
whether these graphics environments will 
succeed unless they are built into the hard- 
ware, a la the Macintosh. Many software 
developers incorporate a graphics environ- 
ment directly in their packages (e.g., pull- 
down menus and mouse support), so that 
the user doesn’t need Windows or GEM. 


GRAPHICS 

One of the main areas of improvement in 
the next year on PCs will be in graphics. 
The graphics capabilities that are cur- 
rently available on high-end workstations 
from Sun, Apollo, and DEC will soon be 
available on AT systems. The EGA-type 
display is gaining wide acceptance as more 
software supports it and price decreases 
make it attractive. Here again, innovators 
are learning how to work within the EGA 
standard to provide performance superior 
to that of the IBM-EGA. Early innovators 
provided features such as Hercules 
compatibility and easier switching be- 
tween modes of operation. Now, innova- 
tors are introducing hardware and soft- 
ware improvements to the EGA standard 
to provide higher resolution and faster 
screen updating. The IBM version of the 
EGA, at this point, is an inferior performer 
at a higher price. 

By mid-year we can expect to see the 
introduction of new graphics controller 
cards utilizing more powerful display- 
controller chips from TI and Intel. These 
controllers will relieve the main processor 
of much of its display control and will al- 
low even faster and more powerful screen 
performance. Software that takes advan- 
tage of these capabilities will begin to ap- 
pear by the year’s end. CAD and page- 
makeup systems will be the biggest 
beneficiaries of these capabilities, and 
WYSIWYG (what you see is what you get) 
will be the standard for many applications. 

I have touched on only a few of the im- 
provements we can expect to see this year. 
There will also be improvements in mem- 
ory, storage, printers, communications, 
and more. These improvements may not 
be as dramatic as in previous years, but 
they are something to look forward to. § 
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BD Software, Inc. 
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RUMORS & GOSSIP 

PC’s Limited, the first company to ship a 
12-Mhz AT clone is rumored to be ready- 
ing 20- and 24-Mhz versions. These would 
probably run faster than the current crop 
of 386-based systems. The firm is also ru- 
mored to be readying a 386-based system 
running at more than 20-Mhz, while all 
current units run at 16-Mhz. Looks like 
PC’s Limited aims to be the fastest kid on 
the block. 

IBM has reportedly stopped producing 
its CGA (Color Graphics Adapter) card 
for the PC and is rumored to be planning 
to cease producing the EGA (Extended 
Graphics Adapter) card. Look for IBM to 
introduce an EGA-Plus card with higher 
pixel density and faster operation than the 
first EGA card. 

There are also reports that IBM is beta- 
testing a PC/XT replacement based on the 
8086. It takes up much less desk space 
than the PC/XT and uses 3!4-inch floppy 
and hard disk drives. The motherboard 
has proprietary ICs and contains the dis- 
play controller (a new high-resolution sys- 
tem), and network and mouse-interfacing 
circuitry. A new version of DOS 3.3 with 
mouse and network support is also being 
tested. Based on past experience, it is not 
wise to assume that a system being beta- 
tested by IBM will actually reach the mar- 
ket. The rumors do give some indication of 
future directions being seriously explored 
by IBM, however. 

Hyundai (from South Korea) is reported 
about to start distribution of a $699 (list) 
PC clone via mass merchandisers such as 
Caldor, Toys-R-Us, Federated, Target, 
and SaveMart. The unit will have one disk 
drive and 512K RAM. Options will include 
a second floppy and a 20Mb hard disk. 
This will probably cause companies such 
as Leading Edge and Epson to withdraw 
from the low end of the PC-compatible 
market. 

AT&T is expected to show a 1986 pre- 
tax loss of $700 to $800 million in its com- 
puter business. Sales of AT&T’s UNIX 
personal computer, made by Convergent 
Technologies, were particularly disap- 
pointing. It is estimated that AT&T sold 
fewer than 2,000 of these units last year— 
10 percent of what it had projected. Look 


for AT&T to deemphasize its computer 
business in favor of its traditional phone 
business. 

Intel, the last U.S. manufacturer of bub- 
ble-memory devices and systems, has fi- 
nally given up and abandoned the busi- 
ness. This leaves the market, which is 
small and specialized, to foreign vendors 
such as Hitachi and Fujitsu. Intel thus fol- 
lows in the footsteps of AT&T, Motorola, 
National Semiconductor, Rockwell Inter- 
national, and Texas Instrument. 

Guess which computer maker spends the 
most money on advertising? As if you 
didn’t already know—it’s IBM. In the first 
six months of 1986, IBM reportedly spent 
$15 million, of which $5 million went for 
advertising PC products. That is more than 
most of IBM’s competitors gross. Guess 
where they spent the largest share? Why, 
in the Wall Street Journal, of course— 
IBM knows where its customers are. 

InfoCorp of Cupertino, California, a 
market researcher, reports that unit sales 
of the Apple Macintosh have surpassed 
those of IBM’s AT (of course, that does not 
take into consideration all the AT clones 
being sold). InfoCorp also reported that 
IBM’s and Compaq’s market share de- 
creased at the expense of Apple and the 
clone makers. IBM is still ranked first, Ap- 
ple second, and Compaq third, with AT&T 
and Leading Edge tied for fourth place, 
and Kaypro and Epson tied for fifth. 

Atari is rumored to be readying a laser 
printer with an under-$1,000 price tag. 
There are already some low-cost desktop 
publishing software packages for the Atari 
ST system. This may round out the system 
package and make the ST more attractive 
to business users. 


286-DOS EXPECTED SOON 
In previous columns I discussed rumors of 
the new version of MS-DOS designed spe- 
cifically for AT-compatible systems. The 
latest rumor is that this will be released in 
the second quarter by both Microsoft and 
IBM. 286-DOS, as it is now being called, 
has been in beta-test since last summer. As 
reported in an earlier column, it will pro- 
vide true multitasking and be capable of 
addressing up to 16Mb of memory. 

There are already more than one mil- 


lion 286 systems installed, and predictions 
are that by midyear this figure will rise to 
more than 3.5 million. Further, sales of 
286 systems are not expected to peak until 
late next year, when 386-based systems go 
into full production. 


32-BIT BUS STANDARD 

Approximately 50 manufacturers, includ- 
ing AT&T, Quadram, Emulex, and Chips 
& Technologies, have committed to sup- 
porting the PCET bus (PC Extended Tech- 
nology) for 80386-based machines. The 
PCET bus was developed by Phoenix Tech- 
nologies Ltd., of Norwood, Massachusetts. 
The bus is an extension of the PC 8-/16-bit 
bus and hence is compatible with boards 
for those systems. As yet, no manufacturer 
has announced a system using this bus. 
Most of the systems that have been an- 
nounced use the standard PC/AT 8-/16- 
bit bus system. 

Compaq Computer, and others, use the 
AT bus and add a 32-bit bus slot capable 
of handling a high-speed memory board. 
This 32-bit bus is not compatible with the 
PCET bus. It is unlikely that IBM will 
adopt the PCET bus as part of its 386 
systems. 


386 MARKET REPORT 

Several companies have released 80386- 
based systems. The current leader is 
Compaq Computer, with its Deskpro-386, 
and that is being shipped only in small 
numbers. 

At this point, there is no software that 
takes advantage of the 386 (one could say 
the same for the 286, except for XENIX- 
286 and Concurrent DOS), so that users 
are running MS-DOS 3.x, letting most of 
the features of the 386 go unused. Micro- 
soft is promising to release XENIX-386 by 
June, but as yet there is no word as to 
when it will release a 386 version of MS- 
DOS—it may not be this year. 

The current potential market for 386- 
based systems thus appears to be limited 
to local area network servers and applica- 
tions such as CAD, where the systems will 
function as faster versions of the AT. 

The current 386 machines, are to a 
great extent, competing with a nonexistent 
IBM system. Many software developers 
and peripheral-board suppliers are waiting 
for IBM to release a 386 system. If this 
does not happen within the next six 
months, however, these companies may 
choose to release products. Lotus Develop- 
ment and Ashton-Tate are known to be 
working on 386-based products. 

Also, most compatible system makers 
are holding off introducing systems, as 
they wait to see what IBM will do. They 
will only wait so long, though. The ques- 
tion is, how long can IBM keep the 386 
market in check by delaying introduction 
of its 386 system? Everyone will be watch- 
ing to see how well the Deskpro-386 does 
within the next six months. If it meets with 
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Uninterruptible 
Power Systems 


Read what the experts say; 


“Clary Corp’s OnGuard 600VA has the mak- 
ings of the perfect UPS: it’s functionally in- 
visible. Whether or not line voltage is avail- 
able, it constantly supplies up to 600VA of 
nearly pure sine-wave power at an almost 
unvarying 120 volts. No UPS is more unob- 


trusive than the OnGuard.” 
-Winn L. Rosch, 


PC Magazine, 
SEPTEMBER 16, 1986 


DISCOVER THE CLARY SOLUTION 


*$1995.00 


Available in 500VA* , 600VA, 
800VA, 1000VA & 1200VA 


SEE \. vf 

~~ LAS TF ® 
CLARY CORPORATION 
320 West Clary Avenue 


San Gabriel, CA 91776 (818) 287-6111 x620 
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For heavy-duty use with large systems, our 
choice is Clary Corp.’s OnGuard 600VA. It has 
sufficient capacity to run a network server with 
external hard disk(s) long enough to bridge 
most outages or shut down the network in an 


orderly manner. Also, it’s quiet enough foran 
$' 


office area and simple enough to use that it can 


be forgotten. 
-PC Magazine, ° 
Editors Choice, 
SEPTEMBER 16, 1986 


e Capable of providing nearly twice its 
rated output capacity (with switching 
power supply loads). 

e Designed for use with your IBM 5362 
& 5364. 

e On-line operation, static bypass switch 
and sinewave output. 

e Fifth generation, high frequency PWM 
technology reducing size and weight by 
over 50%. 

e Capable of running 135-watt PC-XT for 
2% hours. 

e Meets FCC Part 15-Class A, NEC and 
IEEE 587 standards. 

e Virtually silent. 

e ULL. listed. 


AMPrIIAARR 
VNVUUANY 


any worthwhile acceptance, other compa- 
nies may not wait for IBM to jump in. If 
they do, will they use the Compaq system 
as a standard? If not, we will have chaos, 
and IBM will have an opportunity to come 
in later and become the standard. 


CONCURRENT DOS UPDATE 

It is interesting to note that Digital Research 
has had Concurrent DOS out for close to 
two years, while Microsoft is only now 
starting to ship its concurrent version of 
MS-DOS (Version 4.0). 4.0 has only lim- 
ited concurrent capability (programs run- 
ning in the background must be specifi- 
cally written for the purpose), while DRI’s 
Concurrent DOS can run most standard 
packages in the background. 

DRI released its latest version of Con- 
current DOS (Concurrent PC DOS XM) in 
September. It has improved PC-DOS 
compatibility, full batch support, and sup- 
ports up to 8Mb of RAM. 

Quadram now bundles a single-user ver- 
sion of XM with its Quad EMS+ 
memory-expansion board. DRI sells a 
three-user version for the PC ($395, or $50 
for owners of Version 4.1). HAAR Indus- 
tries (2600 Virginia Ave. NW, Ste. 600, 
Washington, DC 20037; (202) 338-8550) 
and Goodall Computer Systems (3770 
24th St., San Francisco, CA 94114; (415) 
648-2174) sell versions that handle up to 
16 users. CompuPro Systems, Nixdorf 
Computer, COMARK, and L/F Technolo- 
gies are selling versions for systems they 
manufacture. The CompuPro and L/F 
Technologies systems are S-100-based. 
The COMARK system is Multibus-based. 

A Concurrent User Group (CONUG, 
Box 734, Marina, CA 93933; (408) 384- 
6797(voice) and (408) 384-5575(mo- 
dem)) publishes a monthly newsletter and 
maintains a software library of concurrent 
utilities and programs (membership is 
$25/year). And, a book titled Concurrent 
PC-DOS ($21.95) is available from Pren- 
tice-Hall (Englewood Cliffs, NJ 07632; 
(201) 592-2498). 


WINDOWING STATUS REPORT 
Microsoft and Digital Research, Inc., have 
been aggressively pushing their Windows 
and GEM windowing systems for well over 
two years with little success. Only a hand- 
ful of software houses have introduced 
packages that run under these front-end 
systems. By contrast, windowing is the rule 
rather than the exception on UNIX-based 
systems. No doubt this is because UNIX 
users do a great deal of multitasking, while 
this is rare for PC/MS-DOS users. This 
should change, however, when Microsoft 
releases its multitasking version of MS- 
DOS, expected later this year. 

Software developers are faced with the 
problem that there is no standard for win- 
dowing. This is true in both the PC and 
UNIX environments. In the UNIX market, 
the leading contenders are NeWS (Net- 


work Extensible Window System) from 
Sun Microsystems and X Windows, devel- 
oped under an industry-financed project at 
MIT. 

ANSI has formed a task group on dis- 
play management to develop a windowing 
standard. At this point, there is no indica- 
tion as to whether the group will pick 
NeWS, X Windows, Windows, or GEM. 
The likelihood is that separate standards 
will be adopted for the PC-compatible and 
UNIX marketplaces—and, that a stand- 
ard will be set when DEC and IBM declare 
their endorsements or introduce their own 
systems. 


WORTHWHILE NEW PRODUCTS 

The ‘‘why-didn’t-somebody-do-this- 
before-department”: The Torrington Co. (59 
Field St., Torrington, CT 06790; (203) 
482-9511) has introduced a cordless PC 
mouse that does not require a tablet. It 
uses infrared technology and transmits to 
al X 2-inch receiver. It has a rechargea- 
ble battery. 

Maynard Electronics of Casselberry, Flor- 
ida, has announced an Enhanced Run 
Length hard-disk controller that it claims 
is even better than standard RLL control- 
lers. Standard RLL controllers increase 
hard-disk capacity by 50 percent. May- 
nard claims its ERLL controller will dou- 
ble the capacity of most hard-disk control- 
lers and improve access time, since the 
heads do not have to move as far as they do 
on most of those other controllers. 

Wyse Technology has introduced what is 
the fastest PC compatible on the market, 
an 8088-based system running at 9.54- 
Mhz, twice the speed of a standard PC. It 
is likely that we will soon see PC- 
compatibles running at well over 10-Mhz. 

Quadram and Paradise Systems, following 
in Vega’s footsteps, have announced EGA 
PC display-controller cards with greater 
resolution, faster operation, and more col- 
ors than earlier cards. These boards take 
advantage of the extended capabilities of 
multisync monitors such as the NEC and 
Sony. 


SOFTWARE PRICES UP 

While prices for systems tumble, prices for 
popular, name-brand software are going 
up or holding their own, despite predic- 
tions of industry sages. For example, 
Microsoft, when it released new versions of 
Word and Project, raised its prices from 
$375 to $450 and from $250 to $395, re- 
spectively. Borland International, the former 
champion of low prices, recently raised the 
price of Reflex from $99 to $149. And, 
Lotus Development raised the wholesale 
price of 1-2-3 three percent, forcing dealers 
to raise their discounted prices, while the 
list price remained constant. 

The general rule seems to be that if a 
product is in demand, raise the price. If it 
is doing poorly, drop the price. Hence, Lo- 
tus, in response to poor sales of Jazz, 


dropped its price from $595 to $395 and 
began offering a $100 rebate. 

Sales of popular software, such as 1-2-3 
and dBASE, have not as yet been affected 
by low-priced software clones, look-alikes, 
or public-domain software. This is quite 
suprising, since some of these programs 
sell for as little as $19.95. 


ATARI VS. COMMODORE SUIT GOES 
TO TRIAL 

Days before Jack Tramiel acquired Atari 
from Warner Communications, Amiga 
Corp. broke off negotiations to license a 
chip set it was developing for Atari. It re- 
turned a half-million-dollar advance to 
Warner and was soon acquired by Com- 
modore, for $25 million. 

Atari subsequently filed suit, charging 
that Atari helped develop the Amiga chip 
set and that Amiga therefore had no right 
to break off negotiations arbitrarily. 

Atari has reportedly already sold more 
than 100,000 ST systems, compared to less 
than 40,000 Amigas sold by Commodore. 
Both companies are currently turning a 
profit, and sales of the ST and Amiga sys- 
tem are expected to increase substantially 
this year. Atari is expected to announce a 
new version of the ST soon with enhanced 
graphics, faster speed, and larger memory 
size. 


PC BUSINESS REBOUND? 

The Wall Street Journal recently reported 
that the Personal Computer business, 
which had been in the doldrums since 
early 1984, is rebounding. They report 


| that IBM, in September, “sold more PCs 


than in any month in its history.” And, 
that Intel said that last year it sold twice as 
many 80286 chips as it had expected to 
sell, and that IBM had trouble meeting the 
demand for AT systems. 

Many industry authorities are predict- 
ing a 20-30 percent industry growth for 
this year. Most of the increase is expected 
in sales of more powerful 286-based sys- 
tems, networks, and desktop publishing 
systems. § 
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DO YOU HAVE A HARD DISK? 


Now You Can Organize It Without Worrying About Long Path Names. 
Why Type 
C:\WRITING\ DOCUMENT \COMMAND\ MAGIC\ 
When you can Type 


MAGIC \\ 


The 


COMMA bon System” 
y 


CompuMiagic” 


Finally, a set of programs that give you control. Put your files where they logically belong. 
Get them when you need them with simple-to-remember short names. This is what you get: 


e Instant Access to Any Directory on Your Hard Disk 
¢ Automatically Generated Short Names For Every Directory 
e All Programs Use Short COMMAND System Names 
e Fast Programs to Copy, Erase, Rename, Move, Compare 
¢ Consistent Command Structure 
e Multiple Operations On a Line 
e Super Programs to Show Files and Directories 


¢ CompuMagic’s SEARCH Program — Search ASCII or Word 
Processor Files by Line or Paragraph 


SPECIAL INTRODUCTORY OFFER 


Save $20 from the regular $95 price. 
Order before March 31 and pay only $75. 


30-day Money-Back Guarantee Never Copy-protected 


The COMMAND System requires DOS 2.0 or higher and includes Full Documentation and a disk with 25 
programs. Call Now with your COD, VISA or MC order, or send check or MO. Free UPS Ground Shipping. 
Add $2 for COD, $5 for overseas. (MD res. add 5%) 


CompuMlagic 
P.O. Box 437 
Severn, MD 21144 
(301) 969-8068 


MAKING COMPUTERS WORK MAGIC SINCE 1983 
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there is mail... 


We welcome your letters, with their com- 
ments, compliments, criticism, and sug- 
gestions. We do not have the staff to an- 
swer all letters personally. All letters 
become the property of M/SJ and may be 
subject to editing. We do not print letters 
that do not include a name and address. 

Please send your letters to: Micro/Sys- 
tems Journal, Box 1192, Mountainside, 
NJ 07092. 
Ree Sas Se Fae 
MULTI-TASKING SYSTEM INFO 
WANTED 
Dear M/SJ: 
I welcome any and all information on 
Concurrent-DOS or Concurrent-CP/M. 
Alex Soya’s articles and user’s letters are 
invaluable. It’s very hard to buy a concur- 
rent bootable system, however. Aside from 
CompuPro ads, no leads are published. 

Please publish a table of micros on 
which Concurrent runs. Include low- 
priced clones, 68000 systems, and versions 
for future release. 

Nelson Richardson 

New York, NY 


Digital Research, Inc., has done a poor 
job of promoting Concurrent-DOS, an ex- 
cellent multitasking system. DRI sells a 
bootable version for PC-based machines. 
Several readers who are running it on AT- 
compatible systems think it is terrific. 
Several companies are using Concurrent- 
DOS for multiuser/multitasking systems. 
The latest release is called Concurrent 
PC-DOS/XM and is available directly 
from DRI. To order, call DRI at (800) 
443-4200. The price is $395 and an up- 
date, for owners of Version 4.1, is only 
$50. Haar Systems, Washington, DC 
((202) 338-8550) sells an enhanced ver- 
sion of Concurrent PC-DOS/XM that will 
accommodate up to 16 users. 

A list of companies selling bootable 
Concurrent-DOS systems will be included 
in Part Il of Alex’s tutorial, which is 
scheduled for the May/June issue. 

Readers should note that DRI’s Con- 
current-DOS-286, Version 1.0, is cur- 
rently being sold by IBM and is called the 
4680 operating system. DRI is working on 
Version 2.0, which is expected to be of- 
fered for sale directly from DRI later this 
year. 

For more information on Concurrent, 
you might log into Alex Soya’s BBS ((305) 
727-0331). There is also an excellent 
newsletter published for Concurrent us- 
ers; write to CONUG (CONcurrent Users 
Group), Box 734, Marina, CA 93933. 
Membership is $25/yr ($35 outside the 
US.). CONUG also has a BBS ((408) 384- 
5575); log on as CONUG GUEST, with the 
password GUEST, for restricted access. 
And, you will also find quite a bit of inter- 
change among Concurrent users on the 
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CompuServe DRI and GEnie CP/M SIGs. 


BACKUP POWER SUPPLY CONFUSION 
Dear M/SJ: 

Reader Carl Voelz (letters, pp. 12-15, 
Sept/Oct 1986 M/SJ) seems to be a bit 
confused about backup power supplies. 
His first point is incorrect (as you must 
have noticed) in two ways. First, in com- 
paring square waves vs. sine waves, the 
peak voltages are chosen (with either 
waveform) to give “heating power” (inte- 
gral under the wave) equal to the same 
nominal DC voltage (a single wave peak is 
1.414 times the sine wave’s nominal] volt- 
age). Thus, heating of a motor would be 
sensibly the same. 

Second, if he’s a fastidious designer, 
he’s going to apply DC, not AC, sine or 
square, to a DC motor in a disk drive. 

I don’t understand his true vs. 
switchover types or the “mu” notation, but 
I do know that transient damage is caused 
by high amplitudes, not by (less than infi- 
nite in practice) rise times. 

To depart from his letter, there are two 
ways to achieve short-term, 
uninterruptable power for a microcom- 
puter. The easier (but more expensive) 
route is to use a DC-powered inverter to 
provide a (usually nonsynchronous) 
11SVAC square wave, into which the com- 
puter’s normal AC supply is plugged. Two 
problems: the inverter is a current hog, 
particularly with light loads, and effi- 
ciency suffers further from multiple cur- 
rent conversions. 

The more efficient route involves using 
the battery DC to power the computer di- 
rectly through high-efficiency switching 
regulators. The battery (a nice, big filter 
capacitor, if you will) can then be float- 
charged from the AC mains. During a 
power outage, the battery takes over and 
continues operation. 

David Mc Lanahan 

Marlow, NH 


PROPOSED FILE LENGTH STANDARD 
FOR CONCURRENT-CP/M AND CP/M 
PLUS 

Dear M/SJ: 

Both CP/M-Plus and CCP/M-86 offer to- 
ken support for recording the exact (byte) 
length of a file in the directory. The 
method is crude, but workable. Using a 


variant of BDOS function 30 (set file 
attributes), a program may set the S1 byte 
in the directory for a file to a value repre- 
senting the number of bytes in the last 
record (sector) of the file. The byte length 
of the file is then: 


(sectors—1) * 128 + lastSectorLength 


In more detail, the process is: 


1. Set up the standard FCB containing the 
name of the file. 

2. Set the F6 interface attribute bit 
(FCB[6]bit 7). 

3. Set the CR field (FCB[32]) to the de- 
sired value. 


Now a call on BDOS function 30 will 
copy the CR field into the SI byte 
(FCB[13]) and record the contents in the 
directory. (The CCP/M manual refers to 
the SI byte as the CS byte.) 

The contents of the S1 byte can be re- 
trieved from the DMA area on an OPEN, 
SEARCH-FIRST or SEARCH-NEXT 
BDOS function, each of which returns a 
small integer value (in the range 0-3) if 
the BDOS function is successful. The re- 
turned value is known as a directory code, 
and the SI (CS) byte is found at: 


DMA|directoryCode * 32 + 13]. 


The DRI documentation suggests that 
the S1 byte be set to hold the number of 
(valid) bytes in the last record (sector) of 
the file. It also says that no DRI utility sets 
or uses the file byte count. 

To my knowledge, there is exactly one 
program that sets the SI byte, and I wrote 
large portions of it. This seems the perfect 
opportunity to establish a standard. 

There is one problem with using the S1 
byte to store the number of valid bytes in 
the last sector. It is difficult to make the 
distinction between zero, meaning no valid 
bytes, and zero, meaning all bytes are 
valid. One could make the assumption 
that S1=0 means all bytes in the last sec- 
tor are valid, while S1 in the range 1-127 
means that only S1 bytes are valid. This 
would be consistent with existing pro- 
grams that do not set the S1 byte. While 
workable, this logic is slightly compli- 
cated. I suggest the following standard: 

When using BDOS function 30 to set the 
byte count for a file, the SI byte should 
represent the number of unused bytes in 
the last sector of the file. While still consis- 
tent with existing programs that do not set 
the byte count, the logic for determining 
the length of a file is slightly simplified 
and is given by: 


sectors * 128— unusedBytes 


Admittedly, the simplification appears 
minimal, but when one comes to write 
code sensitive to file byte counts, there is a 
substantial reduction in complexity with 
the proposed standard. 

John Hastwell-Batten 
Dural, Australia § 
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ALL SALES ARE MADE SUBJECT TO THE TERMS OF OUR 90 DAY LIMITED WARRANTY. A COPY OF THIS WARRANTY IS AVAILABLE FREE, ON REQUEST. 


DIGITAL RESEARCH COMPUTERS (214) 225-2309 
TEXT TO SPEECH BOARD! HOT COMPUTER BOOKS! 


PC/XT COMPATIBLE. MAKE YOUR COMPUTER TALK! GET THE MOST OUT OF THE INVESTMENT YOU MADE IN YOUR 


A VERY POWERFUL AND AMAZING SPEECH CARD. USES THE NEW GENERAL 
INSTRUMENTS SP0256-AL2 SPEECH CHIP AND THE CTS256A-AL2 TEXT TO COMPUTER HARDWARE AND SOFTWARE WITH THE NEW WORDWARE 


SPEECH CONVERTER. SERIES OF COMPUTER REFERENCE AND TRAINING MANUALS. LEARN 
THIS BOARD USES ONE SLOT ON THE MOTHER- HOW TO MAKE ALL THAT EXPENSIVE SOFTWARE YOU BOUGHT REALLY 


BOARD AND REQUIRES A COM SERIAL PORT. A 
BOARD MAY ALSO BE USED IN A STAND ALONE COOK! BUY ANY 3: TAKE AN EXTRA 10% DISCOUNT! 


ENVIRONMENT WITH ALMOST ANY COMPUTER 

THAT HAS A RS232 SERIAL PORT. FEATURES ON 

BOARD AUDIO AMP OR MAY BE USED WITH 

EXTERNAL AMPS. 

DEMONSTRATION SOFTWARE AND A LIBRARY BUILDING PROGRAM ARE 
INCLUDED ON A 5% INCH PC/XT DISKETTE. FULL DOCUMENTATION AND 
SCHEMATICS ARE ALSO INCLUDED. 


95 89 95 


a a 
COMPLETE KIT ASSEMBLED & TESTED 
$100 BUSS 


HARD DISK CONTROLLER CARD ° LIVES! 
THE FANTASTIC KONAN KDC-230. WITH MANUAL. SUPER EASY WE ‘ 
STILL SELL 
TO CONFIGURE AND USE. $100 PRODUCTS 
HALF SIZE PCB. ‘99° — ADD $8.00 FOR CABLES ‘ AND CP/M 


SINGLE BOARDS. 


MEX-PC MODEM 49 95 ADVANCED TURBO PASCAL , FREE CATALOG. 
SOFTWARE PACKAGE " PROGRAMMING TECHNIQUES 


A FANTASTIC COMMUNICATIONS PACKAGE WITH FEATURES TOO . i i 
NUMEROUS TO LIST. SEE MAY/JUNE '86 MICRO SYSTEMS JOURNAL FOR SCHEMA: Schematic Capture and Drawing Package 


FULL REVIEW OR CALL FOR BROCHURE. SUPPORTS COLOR, KERMIT WORKS WITH PC’S AND COMPATIBLES. EASY TO USE WITH OFF THE SHELF 
PROTOCOL, Y MODEM BATCH, VT100 EMULATION, REMOTE OPERATION, PRINTERS, MOUSES, VIDEO CARDS, ETC. COMES COMPLETE WITH A HUGE 
ON LINE HELP, ETC. RUNS UNDER PC/MS DOS. 180 PAGE MANUAL & BINDER. COMPONENT DATABASE. SUPPORTS MONOCHROME, COLOR, OR EVEN EGA. FREE 


MEX-PACK LIST IS $99.95 — SPECIAL $49.95 


BROCHURE AND DEMO DISKETTE ON REQUEST. LIST $500 — SPECIAL $396.15 


NEW! oe PC/XT AT 
PC/XT EPROM Ln ENHANCED GRAPHICS ADAPTER 


PROGRAMMER 
$199 


* LATEST DESIGN * PROGRAMS UP TO 4 DEVICES AT ONE TIME * FEATURES + 3 CARDS IN ONE! 

EASY TO USE MENU DRIVEN SOFTWARE THAT RUNS UNDER PC OR MS-DOS. * 100% IBM COMPATIBLE. 

* USES AN INTELLIGENT PROGRAMMING ALGORITHM FOR SUPER FAST + COMPATIBLE WITH IBM EGA, COLOR GRAPHICS ADAPTER, OR 
(8X) EPROM BURNING, * THIS PLUG-IN BOARD ATTACHES TO AN EXTERNAL MONOCHROME ADAPTER. 

MINI CHASSIS CONTAINING 4 TEXTOOL Z.I.F. SOCKETS. * NO PERSONALITY * 256K VIDEO RAM! (4 TIMES MORE THAN IBM!) 

MODULES REQUIRED * AUTOMATIC VPP SELECTION: 12.5V, 21V, OR 25V. * DUAL FREQUENCY OUTPUT FOR EITHER EGA OR 

* EPROM DATA CAN ALSO BE LOADED FROM OR SAVED TO A DISKETTE. STANDARD RGB COLOR MONITORS. 

* PROGRAMMING SOFTWARE SUPPORTS: 2716, 2732, 2732A, 2764, 2764A, * PERFECT MATE FOR NEC MULTISYNC COLOR MONITOR! 
27128, 27128A, 27256, 27256A, 27512, AND 27512A. * ASSEMBLED AND TESTED, * LIGHT PEN INPUT. 

BURNED. IN WITH MANUAL. $199 WITH SOFTWARE. * FULL 16 COLORS. 


* PARALLEL PRINTER PORT. 
MICROTEK 2 M.B. EXPANDED MEMORY BOARD $1 95 (O. K) * A SUPERIOR BOARD AT ABOUT 1/3 THE COST OF IBM EGA! 


MEETS LOTUS/INTEL/MICROSOFT SPEC. FOR EXPANDED MEMORY. FOR USE AS 
EXPANDED MEMORY (EMS), ELECTRONIC DISK, OR PRINT SPOOLER. WITH A SUPERB i sont Ue ableey sapsrlogeat neatly WITH MANUAL. 
MANUAL AND INSTALLATION SOFTWARE. FOR PC/XT OR MOST COMPATIBLES. FOR 2 * USE & . . 

MEGABYTES OF 150 NS RAM (72 DEVICES) INSTALLED AND BURNED IN ADD $225. * FIELD PROVEN BIOS. 


ZRT-80 CRT TERMINAL BOARD! aN THE NEW 65/9028 VT 
A LOW COST 2-80 BASED SINGLE BOAR NLY 
ASCII KEYBOARD, POWER SUPPLY, AND VIDEO MONITOR TO MAKE A ANSI VIDEO TERMINAL BOARD! 
COMPLETE CRT TERMINAL. USE AS A COMPUTER CONSOLE, OR _* FROM LINGER ENTERPRISES * — ; 
WITH A MODEM FOR USE WITH ANY OF THE PHONE-LINE COMPUTER A second generation, low cost, high performance, mini sized, single board 
SERVICES. , for making your own RS232 Video Terminal. This highly versatile board 
FEATURES: * can be used as a stand alone video terminal, or without a keyboard, as a 
* Uses a Z80A and 6845 CRT 2 Pies ; : video console. VT100, VT52 Compatible. MICRO SIZE! 


Controller for powerful video 
capabilities. , ¢ 4 FEATURES: a 
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Upper & lower case with descenders CHAR. ROM. 2732 MON. ROM 
7 x 9 Character Matrix. 95 
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P.O. BOX 381450 » DUNCANVILLE, TX 75138 « (214) 225-2309 insurance. Prices subject to change without notice. 
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Turbo Pascal 
Corner 


by Stephen Randy Davis 


This column features tips and techniques 
for using Turbo Pascal productively on 
MS/PC-DOS and CP/M microcomputer 
systems. It discusses typical problems 
and their solutions. Reader suggestions, 
comments, and questions are encouraged. 
Address them to Turbo Pascal Corner, 
Route 5, Box 107K, Greenville, TX 75401 
or through MCI mail, 289-6124. 


There have been several winners of the 
free public-domain software mentioned in 
the July/August column. For those read- 
ers unfortunate enough to have missed 
that column, I offered a disk of public- 
domain utilities to anyone submitting a 
problem or topic worthy of consideration 
in this column. The offer still stands, so 
keep those cards and letters coming! You 
can’t win if you don’t send it in. 

Two commercial products have recently 
crossed my desk and I feel obliged to men- 
tion them. TurboPower Utilities has be- 
gun marketing a commercial version of 
David Baldwin’s source-level Turbo 
debugger mentioned earlier under the 
name T-Debug Plus. This new version 
adds a few features to the public-domain 
TDebug, and I trust that TurboPower will 
continue to add more. This is a good buy if 
you do not have access to the public- 
domain version or if you need the cus- 
tomer support that TurboPower provides. 

How many of you have run up against 
the 64K code limit of Turbo? Of course, 
there are always overlays, but for those of 
you to whom overlay is a bad word, Path- 
Finder Software at P.O. Box 43, Littleton, 
CO 80160, now offers TurboLink+. Not 
only does TurboLink+ support a large 
model for Turbo, but it also allows you to 
link Turbo modules with Turbo Prolog, C, 
Microsoft Pascal, assembler, and even in- 
terpretive and compiled BASIC programs. 
I cannot exactly recommend the technique 
used, but it does seem to work. 

It looks like reviews of Turbo Pascal 
utilities are becoming a regular part of this 
column. I will review any such utilities 
that I receive. 


TODAY'S TOPIC 
One area with which not enough Turbo 
Pascal programmers concern themselves is 
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Some Worthwhile 
Turbo Utilities & 
Addressing in 
Pascal 


that of addressing. Even an avowed 
nonassembler should have some under- 
standing of how Turbo handles addresses. 

For example, did you know that vari- 
ables declared globally are more than 
twice as fast to access as variables de- 
clared locally to a procedure? (Globally 
declared variables are declared outside of 
any procedures.) A benchmark I wrote to 
test this effect took 0.7 seconds to run with 
global variables and 1,9 seconds with iden- 
tically declared local variables. Global 
variables occupy specific memory loca- 
tions, just like code, while local variables 
are stored on the stack, requiring more 
clock cycles for access on the 8088 or Z80. 
This effect is less pronounced on an AT 
because the 80286 processor is more effi- 
cient in accessing the stack. Knowing this, 
you can always speed up procedures by as- 
signing arguments to global variables be- 
fore manipulating them extensively and by 
using globally declared variables when- 
ever reentrant code is not a consideration. 

Another area in which addressing arises 
is that of argument passing. Did you ever 
wonder why sometimes arguments to pro- 
cedures are declared with a “Var” 
preceeding them and sometimes they are 
not? If so, try the following program: 


Var 
a,b:Integer; 


Note that changing the Var variable b 
within the procedure also changes its value 
in the main routine, whereas changing the 
non-Var a has no effect in the main rou- 
tine. This is because a is being passed by 
value. That is, the value 1 is passed to the 
procedure Test, which stores this into its 
own variable a. By adding the Var, you 
instruct Turbo to pass not the value of b 
but the address of b. Accesses of the vari- 
able b from within Test refer to the same b 
as from the main routine. Thus, changing 
b within the procedure changes its value 
everywhere. 


Var variables represent but one case 
where addresses are useful. “C” program- 
mers become used to referring routinely to 
addresses of variables, arrays, and 
routines. Most become discouraged that 
Pascal apparently has no such ability. 
True, Chapter 15 of the Turbo manual in- 
troduces pointer variables, but it only de- 
scribes them in terms of records. 

Don’t misunderstand me—linked lists 
of records via pointers to records is an im- 
portant application of addresses. My point 
is that Pascal allows pointer variables to 
point to anything. For example, the fol- 
lowing declarations are all quite legal: 


Type 
Ptr = “Integer; 


String=Array[1. .15] of 
Integer; 

StrPtr = “String; 

PtrPtr = “Ptr; {pointers to 


pointers are even 
allowed} 


The list of possible applications is lim- 
ited only by one’s imagination. For exam- 
ple, pointers can be used to declare data 
structures larger than 64K. Suppose you 


Procedure Test (a:Integer;Var b:integer); 


Begin 
WriteLn (‘a = ',a,' b = ",D); 
a := 10; b:= 20; 
WriteLn ('a = ',a,' b = ',b) 
End; 
Begin 
az= 13; b:= 2; 
Test (a,b); 


WriteLn ('in main routine a = 
End. 


‘,a,' b = ',b) 
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wanted to save as many display screens as 
you had memory space for. Readers of my 
last column will remember that the dis- 
play screen on a PC compatible can be 
viewed as a matrix of 80 X 25 integers. 
Listing 1 shows the portion of the program 
that allocates space for as many screens as 
possible given available memory. 64K is 
no limit here! 

Have you ever attempted to pass a pro- 
cedure to another procedure? By this I do 
not mean a call such as: 


ProcTwo (ProcOne (arg) ) 


for this is nothing more than passing the 
results of ProcOne to the second procedure, 
ProcTwo. I mean really passing ProcOne to 
ProcTwo. Wirth foresaw such declarations 
in his original definition of Pascal, but 
Borland did not provide for this in Turbo. 
With a little trickery, however, you can re- 
introduce the passing of procedures to pro- 
cedures. Listing 2 demonstrates the calling 
of procedures indirectly. 

Why would you ever want to call proce- 
dures indirectly? “C” programmers can 
tell you that it becomes possible to build a 
routine that can sort anything, if you can 
provide two routines: one to compare two 
things, and one to swap two things. You 
can then use the same sort routine to sort 
social security numbers, real numbers, lat- 
itude/longitude pairs, or whatever. It is 
just as easy to generate arrays of proce- 
dures to be called rapid fire from For 
loops, or depending upon a calculated inte- 
ger index—doing it this way generates 
much smaller and faster code than a case 
statement. 


Note that Z80 Turbo users can partici- 
pate in the same trick. First, replace Ofs( ) 
with Addr( ). Second, replace the 8086 as- 
sembler in Indirect ( ) with something like 
the following (this should work, but I have 
no way of testing it): 


POP HL 
EX (SP) ,HL 
JP (HL) 


CONCLUSION 

Sometimes it is advantageous to consider 
the assembler code being generated by the 
Turbo code you write. If something here 
needs further clarification, or if you have 
another problem that you would like to see 
covered, send it in and I will try to send 
you your copy of public-domain Turbo 
utilities. § 


Stephen Randy Davis is a senior sys- 
tems programmer for a defense contrac- 
tor in Greenville, Texas, where he pro- 
grams various microprocessors. He is 
also working on his Masters in physics. 


{Listing #1 -- 

this program demonstrates that Turbo Pascal is not limited 
to arrays 14k bytes or less as is commonly felt. By using the 
heap, the only real limitation on the size of data arrays is 
system memory. The calls New, MaxAvail, and SizeOf are 
described in the Turbo manual. } 


Type 
Screen = Array [0..24] of Array [0..79) of Integer; 
SernPtr = *Screen; {pointer to a screen} 


Var 
Images : Array [0..99] of ScrnPtr; 
Max : Integer; 
Memory : Real; 


Begin 
max := 0; 
while maxavail > (sizeof(Screen) div 16) do 
{MaxAvail answers in paragraphs} 
begin 
new (Images[max]); 
max := max + 1 
end; 
WriteLn (‘number of blocks of ',sizeof(Screen),' bytes 
allocated is ',max); 
Memory := 1.0*max*sizeof (Screen) ; 
WriteLn ('total allocated storage of ',Memory:6:0,' bytes'); 
If Memory > 65535. Then 
WriteLn ('the magic 64k boundary has been breached! ') 
end. 


{Listing #2 -- 
This program demonstrates the passing of one routine as an 
argument to another. } 


Type 
Address = Integer; 
{lets make up a type for pointers to routines} 
Var 
RoutineAdr : Address; 
{we will store the address of Target here} 


{we use Indirect to effect the indirect call} 
Procedure Indirect (Routine:Address;AnotherArg:Integer) ; 
Begin 


Inline ( 
{get the target address} 
$8B/$86/Routine/ {MOV AX, [BP+Routine] } 
{now pull the stack frame down} 
$8B/S$ES/ {MOV SP, BP} 
$5D/ {POP BP} 
{and then jump to target routine} 
SFF/SEO) { IMP AX} 
End; 


{target routine must have same arguments as Indirect} 
Procedure Target (Dummy:Address;AnotherArg: Integer) ; 
Begin 
WriteLn ('We made it to the target procedure 
(2nd arg =',AnotherArg:4,')') 
End; 


Begin 


RoutineAdr := Ofs (Target); {put addr of Target into variable} 


WriteLn ('Here we go!'); 

Indirect (RoutineAdr, 2); 

WriteLn ('We made it back OK also') {show that we got back} 
End. 
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The C Forum 


by Don Libes 


cdecl—A Program 
to Explain C 
Declarations 


This column features tips and techniques for using the C lan- 
guage productively. It discusses typical problems with using C 
and their solutions. Reader suggestions, comments, and ques- 
tions are encouraged. Address them to ‘The C Forum,” Micro/ 
Systems Journal, Box 1192, Mountainside, NJ 07092. 


cdecl is a program for encoding and decoding C-type declara- | 
tions. It was written by Graham Ross (tektronix | 
'tekmdp!grahamr). It is available from mod.sources on Usenet | 
and is in the public domain. The entire source follows this article. 

cdecl is easy to use. You simply run it and type in C declara- 
tions or English descriptions of C declarations. cdecl will convert 
either of those forms back and forth as necessary. cdecl also con- 
structs casts. For example, if I type: 


explain int (*f00)( ) 

cdecl responds: 

declare fooas pointer to function returning int 

If I type that in, cdecl prints the original declaration. 


Some more examples: To declare an array of pointers to func- 
tions like malloc( ), type: 


declare fptab as array of pointer to function 
returning pointer to char 


The result is: | 


char *(*fptab[])() 


The proper declaration for UNIX’s signal() cannot be de- 
scribed in cdecl’s language (it can’t be described in C either). An 
adequate declaration for most purposes is given by: 


declare signal as function returning pointer to 
function returning int 


int (*signal())() 
The function declaration that results has two sets of empty 


parentheses. The author of such a function might wonder where 
the parameters go. 
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declare signal as function (sig_args) returning 
pointer to function (other_args) returning int 


provides the solution: 
int (*signal(sig_args) )(other_args) 
To cast something into signal’s type (it must be a pointer to it): 


cast foo into pointer to function returning pointer 
to function returning int 


(int (*(*)())())f£00 

So the next time you have to figure out how to: 
declare fooas function returning pointer to 
function returning pointer to array 5 of pointer to 
pointer to pointer to pointer to function returning 
pointer to function returning pointer to function 


returningfloat 


you will know to write it as: 


| £loat (*(*(**#*(*(*f00())())[5]1)0))())0) 


COMMAND LANGUAGE 

There are four statements in the language. The declare statement 
composes a C-type declaration from a verbose description. The 
cast statement composes a C-type cast as it might appear in an 
expression. The explain statement decodes a C-type declaration, 
producing a verbose description. The help statement describes the 
others. 

The following grammar describes the language. In the gram- 
mar, words in < > are nonterminals, and bare lowercase words 
are terminals that stand for themselves. Bare uppercase words are 
other lexical tokens: NOTHING means the empty string; NAME 
means a C identifier; NUMBER means a string of decimal digits; 
and NL means the new line character. 

:: = NOTHING 

| (program) (stat) NL 
:: = NOTHING 

declare NAME as (decl) 

icast NAME into (decl) 

1explain (cdecl) 

thelp 
::= array of (decl) 

tarray NUMBER of (decl) 

function returning (decl) 

|function ( NAME ) returning (decl) 

i pointer to (decl) 

i (type) 

:= (cdecl1) 

1* (cdecl) 
::= (cdecl1) () 

'(cdecl1) [] 


(program) 


(stat) 


(decl) 


(cdecl) 


(cdecl1) 


1({cdecl1) [ NUMBER ] 

1( (cdecl) ) 

|NAME 
:= (typename) i (modlist) 

i(modlist) (typename) 

i struct NAME! union NAME! enum NAME 
(typename) ::= inticharidoubleifloat 
(modlist) ::= (modifier) i(modlist) (modifier) 
(modifier) ::=shortilongiunsigned 


WARNINGS 


cdecl is somewhat lacking in error messages. It swallows syntacti- 
cally incorrect statements without complaint, although the de- 
clare statement tries to point out constructions that are not sup- 
ported in C. Also, certain nonportable constructs are flagged. 

Lastly, cdecl won’t help you figure out storage classes or 
initializations. 


SOURCES 
Following this article are the sources to cdecl. Included are a 
grammar file that should be run through yacc, a tokenizer that 
should be run through lex, and some utility routines. Compile 
them together and you will have cdecl. (Austin Code Works sells 
yacc and lex if you don’t already have them.) 

Note that some C libraries use strchr( ) instead of index( ). In 
that case, use the appropriate #define. § 


(type) 


Don Libes is a computer scientist working in the Washington, 
D.C. area. He works on artifical intelligence in robot control 
systems. 


/* cdecl.y - yacc grammar for cdecl */ 
%{ 
#include <stdio.h> 


#defineMB SHORTOO001 
#defineMB LONGOOO2 
#defineMB UNSIGNEDO004 
#define MB INTOO10 
#define MB CHARO020 
#define MB FLOATO040 
#define MB DOUBLEO100 


int modbits 
int arbdims 
char *savedtype; 

char *savedname; 

char *ds(}, *cat(); 

char *index(), *malloc(); 
char prev; 

%} 


ie) 
1 


? 
, 


$union { 

char *dynstr; 
struct { 

char *left; 
char *right; 
} halves; 


} 


%token DECLARE CAST INTO AS HELP EXPLAIN 

%token FUNCTION RETURNING POINTER TO ARRAY OF 

%token <dynstr> NAME NUMBER STRUCTUNION UNSIGNED LONG SHORT 
$token <dynstr> INT CHAR FLOAT DOUBLE 

%type <dynstr> mod_list tname type modifier 

%type <dynstr> cdecl cdecll cdims adims c type 

%type <halves> adecl ~ 


%start prog 


S% 
prog: /* empty */ 
| prog stat 


7 


stat: HELP 
{ 

help (); 

} 

| DECLARE NAME AS adecl '\n' 
{ 


"\n' 
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mere err rn 


printf ("%s %sts%s\n", savedtype, $4. left, $2,$4. right); 
free ($4. left); 

free ($4.right); 

free ($2); 

} 

| CAST NAME INTO adecl ‘'\n' 

{ 

if (prev == 'f') 

unsupp ("Cast into function"); 

else if (prev=='A‘' || prev=='a') 
unsupp ("Cast into array"); 

printf ("(%s", savedtype) ; 

if (strlen ($4.left) +strlen($4.right) ) 
printf£(" tsts",$4.left,$4,.right); 
printf (") $s\n",$2);7 

free ($4.left); 

free ($4.right); 

free ($2); 

} 

| EXPLAIN type cdecl '\n' 

{ printf("declare ts as %sts\n",savedname,$3,$2); } 
| "\n' 

| error '\n' 

{ 

yyerrok; 

} 


, 


edecl cdecli 
| '** cdecl 
{ $$ = cat ($2,ds("pointer to "),NULL); } 


, 


edecll: cdecl1 '({' ‘')' 

$$ = cat ($1,ds("function returning "),NULL); } 
cdecll cdims 

$$ = cat ($1,ds ("array "),$2); } 

"(" cdecl ')' 

$$ = $2; } 

NAME 


avename ($1); 
$=ds (""); 


Od ak en 


cdims: '{' ']' 

{ $$ = ds("of "); } 

| '{' NUMBER ‘']' 

{ $$ = cat ($2,ds(" of "),NULL); } 
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adecl: FUNCTION RETURNING adecl 

{ 

if (prev == 'f') 

unsupp ("Function returning function"); 
else if (prev=='A' || prev=='a') 

unsupp ("Function returning array"); 
$$.left = $3.left; 

$$.right = cat (ds("()"),$3.right, NULL) ; 
prev = 'f'; 

} 

| FUNCTION '(' NAME ‘)' RETURNING adecl 
{ 

if (prev == 'f') 

unsupp ("Function returning function") ; 
else if (prev=='A' || prev=='a') 

unsupp ("Function returning array"); 
$$.left = $6.left; 

$$.right = cat (ds("("),$3,ds(")"))7 
$$.right = cat ($$.right,$6.right, NULL) ; 
prev = 'f'; 

} 

| ARRAY adims OF adecl 

{ 

if (prev == 'f') 

unsupp (“Array of function"); 

else if (prev == 'a') 

unsupp ("Inner array of unspecified size"); 


if (arbdims) 
prev = ‘a'; 
else 


prev = 'A'; 
$$.left = $4.left; 
$$.right = cat ($2,$4.right, NULL); 


} 
| POINTER TO adecl 


{ 
if (prev == ‘a') 
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unsupp ("Pointer to array of unspecified dimension") ; 
if (prev=='a' || prev=='"A' || prev=='f') { 

$S.left = cat ($3.left,ds ("(*") ,NULL) ; 

$$.right = cat (ds(")"),$3.right,NULL) ; 


Modula-2 


} else { 

$$.left = cat ($3.left,ds("*") ,NULL) ; 
$$.right = $3.right; 
} 

prev = 'p'; 

} 

| type 

{ 

savetype ($1); 
$$.left = ds(""); 
$$.right = ds(""); 
prev = 't'; 

} 


, 


adims: /* empty */ 


1 { 


arbdims = 1; 

$$ = ds("()")7 

} 

| NUMBER 

{ 

arbdims = 0; 

$$ = cat (ds("("),$1,ds("]"))7 
} 


? 


type: tinit c_type 
{ mbcheck({); $$ = $2; } 


7 


tinit: /* empty */ 
{ modbits = 0; } 


? 


c_type: mod_list 

{ $$ = $1; 

| tname 

{ $$ = $1; } 

| mod_list tname 

{ $$ = cat ($1,ds("_"),$2)7 } 
| STRUCTUNION NAME 

{ $$ = cat ($1,ds("_"),$2)7 } 


tname: INT 

modbits |= MB_INT; $$ = $1; } 
CHAR 

modbits |= MB CHAR; $$ = $1; } 
FLOAT 

modbits |= MB FLOAT; $$ = $1; } 
DOUBLE 

modbits |= MB DOUBLE; $$ = $1; } 


9a ee ee en ee ee 


mod_list: modifier 

{ $$ = $1; } 

| mod_list modifier 

{ $$ = cat ($1,ds("_"),$2); } 


7 


modifier: UNSIGNED 

modbits |= MB UNSIGNED; $$ = $1; } 
LONG = 

modbits |= MB LONG; $$ = $1; } 
SHORT 

modbits |= MB SHORT; $$ = $1; } 


$% 

#include "cdlex.c" 

#define LORS (MB _LONG|MB SHORT) 
#daefine UORL (MB UNSIGNED |MB LONG) 
#define UORS (MB_UNSIGNED|MB_SHORT) 
#define CORL(MB_CHAR|MB_LONG) 
#define CORS (MB _CHAR|MB_ SHORT) 
#define CORU(MB_CHAR|MB_ UNSIGNED) 


mbcheck () 
{ 
if ((modbits&LORS) == LORS) 


unsupp ("conflicting 'short' and ‘long'"); 


if ((modbits&UORL) == UORL) 
unport ("unsigned with long"); 
if ((modbits&UORS) == UORS) 
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IBM PC/DOS 
Native Code Compiler 


This is a full implementation of Niklaus Wirth’s Modula-2 
language. Our product is not an interpreter, but a true 8086 
compiler, using state-of-the art techniques. A Unix-like 
"make" utility is included which provides automatic recom- 
pilation of modified source programs. 


The code generator produces object module input for the 
DOS link utility. You may combine your Modula-2 pro- 
grams with code from other languages such as Assembler. 
The software also operates on PC compatibles using 
MS/DOS. All the run time source code is included. None 
of the software is copy protected, and is fully supported and 
maintained by farbware. No royalties are charged for the 
use of the run time object. A complete and comprehensive 
reference manual is included in the purchase price. The 
manual is available separately for $25.00. 


Site licenses and quantity discounts are available. 


$89.95 Complete 


farbware 
1329 Gregory 
Wilmette, IL 60091 
(312) 251-5310 


Master Card and Visa Accepted 


THE PROVEN 
MICRO FAMILY 


mam’ SLICER’ 


INDUSTRY 
APPLICATIONS 


VAS . 
«se New Low Prices! 


*Multi-User Slicer Combo 
Slicer SBC A&T (No RAM) 
Slicer 1 MEG Board A&T (Complete) 
CCP/M by Digital Research Inc. 
Slicer SBC A&T 256K 
*Slicer SBC A&T 128K 
with double deck sockets for additional 128K 
*Slicer SBC A&T (No RAM) 
*Slicer 1 MEG Board A&T 
*Slicer 1 MEG Board (Full Kit) 
Slicer PC Expansion Board A&T 
CCP/M (Digital Research Inc.) 
MS DOS (Micro-Soft Corp.) 
*New Slicer Bios for MS DOS 


Other kit forms available - Enclosures & other support hardware 
in stock - Call or write for latest information & prices! 


SLICER COMPUTERS INC. 


2543 Marshall Street N.E. (612) 788-9481 
Minneapolis, MN 55418 BBS (612) 788-5909 


unport ("unsigned with short"); 
if ((modbits&CORL) == CORL) 
unsupp ("long char"); 

if ((modbits&CORS) == CORS) 
unsupp ("short char"); 

if ((modbits&CORU) == CORU) 
unport ("unsigned char"); 

} 


BOBCAT 


The finest disk catalog program available 
for PC—DOS or CP/M 


savetype (s) 


* Keeps track of files on floppies or hard disks char *s; 
*® — Compatible with PC - DOS 2.0 or 3.0; CP/M 2.2 or 3.0 { 
* — Contains the most advanced features: savedtype = Ss; 
— 65 character individual file comment line 
— 45 character individual disk title 
— ASCII BOBFILE (disk number file) storing the disk ae 
title and file comment lines. Great for quick finds : 
or looks in each disk or directory { 
— full directory and subdirectories compatibility savedname = s; 
%*% =~ Filecommentiines for both text and binary files } 
* 
* Unprotected for ease of use /* cdecl.1 - tokenizer for cdecl */ 


A proven utility sold since 1981 %{ 


#include <ctype.h> 


char *visible(); 


US Residents $49.95 US funds 


Canadian Residents $49.95 Canadian funds %} 
Other Countries $54.95 US funds ol 

plus $3.00 postage and handling pe ser -2] 
Ontario Residents please add 7% sales tax a as 


Extra DOS or li - . y 
licenses ~ $15.00 each to $75.00 maximum penn AuaN 


asreturn AS; 

castreturn CAST; 
declarereturn DECLARE; 
explainreturn EXPLAIN; 
functionreturn FUNCTION; 
helpreturn HELP; 
intoreturn INTO; 
-ofreturn OF; 
pointerreturn POINTER; 
returningreturn RETURNING; 
toreturn TO; 


= MASTERCARD, VISA, BANK DRAFTS, MONEY ORDERS 
COMPANY CHECKS, PURCHASE ORDERS 
Please allow 10 days clearance for PERSONAL CHECKS 


R&i. MicroServices Inc. 
Box 159655, Station F 
Otiswa, Ontario, Canada 


K2C 3$8 (813)225 - 7904 The home of the BOBCAT 


char{ yylval.dynstr = ds(yytext); return CHAR; } 
a a a ae ac enna Meena double{ yylval.dynstr = ds(yytext); return DOUBLE; } 
7 / /-/-| enum{ yylval.dynstr = ds(yytext); return STRUCTUNION; } 


4 a i float{ yylval.dynstr = ds(yytext); return FLOAT; } 
° "K All] int{ yylval.dynstr = ds(yytext); return INT; } 
¥. 6. « z {Vi} long{ yylval.dynstr = ds(yytext); return LONG; } 
. e ae Es Hit short{ yylval.dynstr = ds(yytext); return SHORT; } 
Hee atts | | struct{ yylval.dynstr = ds(yytext); return STRUCTUNION; } 
XN Y. union{ yylval.dynstr = ds(yytext); return STRUCTUNION; } 
“ee a unsigned{ yylval.dynstr = ds(yytext); return UNSIGNED; } 
0 PPP 
a , eto {A}{AN}*{ yylval.dynstr = ds(yytext); return NAME; } 
; se ee cael “Pibessgsth (N}+{ yylval.dynstr = ds(yytext); return NUMBER; } 
a" @aa Qa ea¢ ai 
; J (\t 1; 
/-f- * t *yytext; 
“It is well that war is so terrible. We should grow too fond of it.” [ \} ()\n}return *yyt 7 


—R. E. Lee at Fredericksburg 


{ 
printf ("bad character 'ts'\n", visible (*yytext) ); 


return *yytext; 


Robert E. Lee would have been very fond of GENRAL. GENRAL simulates the anxiety, uncer- } 
tainty. and despair felt by the commanders of armies in an imaginary war taking place a century $t 
or so ago. GENRAL is char * 
a TWO-PLAYER game. It requires TWO CP/M-80 or IBM PC computers communicating 
via modem or cable at 300 baud. The computers are non-playing ““umpires”’; they produce visible (c) 


Statistical reports and animated displays of the battle situation, and relay the players’ com- { 
mands between the machin: 
7 7 = static char buf[5]; 
a REAL-TIME game. It is always “your turn’. The video display changes continually 
as time passes. 


ce &= 0377; 
a COMPLEX game. Each player controls an army of twenty-six units. There can be if (isprint(c)) { 
action in several places at once. and the decision which to attend to first can be critical buf [0] = Cc; 
a SERIOUS game. It has had over five years of development and testing. A typical buf (1] = '\0'; 
game lasts about two hours and requires constant, intense concentration. The game has } else 
menst ty of ble situations, and t tale with ted pl: 
an im e variety of possible situati does not grow stale with repeated playing. sprint f (buf, "\\%020",c); 
GENRAL is available from: Tee-Kay Software return buf; 
P.O. Box 23771 } 
Columbus, Ohio 43223 
Diskette and User's Manual $50.00 * - * 
User's Manual only: $10.00 /* cdsupp.c support routines for cdecl */ 
Serial /O Software Listings:  $ 2.00 #include <stdio.h> 


* : 
A vanety of 5" CP/M disk formats is available (including Apple), as well as standard 8" SSSD char *malloc ( 3 


Specify desired format when ordering. NOTE: The CP/M version may required a small amount 
of customization of screen and modem control software. Sample ASM sources (8080 code) main () 
are included on the GENRAL diskette. Listings are available on request { 


yyparse (); 
} 
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LSEARCH 3.0 dBASE Ill 
— A GENERAL-PURPOSE CATALOGUE SYSTEM WITH FAST, MULTIKEY BOOLEAN SEARCH — 


* User abstracts keywords from source materials: 


REAL ESTATE LISTINGS RESUME’S 

LEGAL TRANSCRIPTS AND DEPOSITIONS PATIENT CHARTS 

COMPANYAND CLIENT PROFILES ARTICLES, BOOKS, CLIPPINGS 
PERSONNEL PROFILES WRITER'S OR RESEARCHER'S NOTES 


HOLIDAY TOURS AND TRIPS 


— Stores the abstracts in a simple universal file structure. 
— Searches the “library” for relevant abstracts using general multikey boolean forms composed of lists of keywords. 


* List syntax for boolean forms is simple; lists are stored to file for easy editing. 
* Search algorithm is FAST. 
* Every application handled in the same way. 


* The all-purpose file structure has just two fields: abstract id number, and keyword. One record for every keyword. User sets the widths of the fields. 
* Categorization of keywords is accomplished by a variable one-character prefix on the keyword (any printable ASCII character). 
* Search lists come in four types: MATCH, NONMATCH, GRTR/= and LESS/=. 
* Multilist queries come in two types: ALL and ANY. An item satisfies an ALL query if it satisfies all the lists (AND logic). 
An item satisfies an ANY query if it satisfies any list (OR logic). 
* A list may have any number of keywords, and any mix of categories 
* Search output is a list of “hits”, the id numbers of the abstracts which satisfy the query, stored to a file. 


Resume Example 
Categories are: T=title, F= function, G=year graduated, P= product area, $= salary, D= degree, M= major, S=school 


keyword (a) experience in Sales and Marketing; not (b) not a steel industry executive (Director, 
T_Asst. Director a VP or Director; 10-15 years work VP. or C.E.O.) 

F_Sales experience; current salary not higher 

G_/3 than $50K. 

P_Fabrics ANY 

P_Yarns NONMATCH 
P_Clothing T_Director 


$_37000 T_VP 
D_MBA F_Marketing T2EEC: 
M_Marketing NONMATCH NONMATCH 
S_Columbia U. T_Director P_Steel 
T_VP. 
GRTR/= 


G_/| 
LESS/= 

G_/6 
LESS/= 

$_50000 


* Searching is fast because all entries across all categories are indexed simultaneously — all “search keys” are inverted at once. 

* The system is menu-driven except for file creation and editing. 

* Users should know dBASE Ill, but don’t need to be programmers. 

¢ dBASE III source code is included, so if you are a programmer you can adapt the system to taste. 

* The system provides an option for automatic encoding of keywords and phrases into 3 or fewer bytes, leading to dramatic disk savings. 
(An application of this type is included with every order: abstracts of dBASE III material from TechNotes.} 


To order, please send a check for $49 + $3.50 (S&H) to 


Thinker’s Apprentice / 392 Central Park West, Apt. 12X / New York, NY 10025 
(212) 222-5050 


(Residents of New York State, please add state and local sales tax.) 


GBASE III is a registered trademark, and TechNotes is a copyright publication of Ashton-Tate 
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unsupp (s) 


char *s; 

{ 

printf ("Warning: Unsupported in C -- %s\n",s); 
} 


unport (s) 

achar *s; 

{ 

printf ("Warning: Non-portable construction -- %s\n",s)7 
} 


yyerror (s) 

char *s; 

{ 

printf ("%s\n",s) 7 
} 


yywrap () 
{ 
return 1; 


} 


/* 
* Support for dynamic strings: 
* cat creates a string from three input strings. 
* Input strings are free'd by cat (so they better have 
been malloc'd). 
* ds makes a malloc'd string from one that's not. 
*/ 


char * 

cat (sl,s2,s3) 

char *si1,*s2,*s3; 

{ 

register char *newstr; 
register unsigned len = 0; 


if (sl != NULL) len = strlen(sl) + 1; 
if (s2 != NULL) len += strlen(s2); 
if (s3 != NULL) len += strlen(s3); 
newstr = malloc(len); 

if (sl != NULL) { 

strepy (newstr,sl); 

free (sl); 

} 

if (s2 != NULL) { 

strcat (newstr,s2); 

free (s2); 

} 

if (s3 != NULL) { 

strcat (newstr,s3); 

free (s3); 

} 

return newstr; 

} 


char * 
ds (s) 
char *s; 
{ 


register char *p; 


Pp = malloc( (unsigned) (strlen(s)+1)); 


strepy (p, S)7 
return p; 
} 


static char *helptext[] = { 


"() means optional; {} means 1 or more; <> means defined 


elsewhere\n", 
“command: \n", 
"declare <name> as <english>\n", 
"cast <name> into <english>\n", 
"explain <gibberish>\n", 
“english:\n", 
"function [( <name>)] returning <english>\n", 
“array [<number>] of <english>\n", 
"pointer to <english>\n", 
"  <type>\n", 
"type: \n" > 
“  [{<modifier>}] <C-type>\n", 
“  {<modifier>} [<C-type>]\n", 
"<sue> <name>\n", 
“name is a C identifier\n", 
“gibberish is a C declaration\n", 
"C-type is int, char, double or float\n", 
"modifier is short, long or unsigned\n", 
“sue is struct, union or enum\n", 
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NULL 


help () 
{ 
register char **p; 


for (p=helptext; *p!=NULL; p++) 
printf ("\t%s",*p); 


| The dBASE 
Book of 
Business 
Applications 


The dBASE Book of Business Applications is a 
tutorial and programming guide for anyone committed to 
automating office systems and maximizing productivity with 
dBASE Il. The task-by-task approach illustrates the flexibility 
of dBASE Il in adapting to your daily business routines. 


The book includes the source code for several working 
application programs including a mailing list manager, a por- 
table computer application, an inventory system, and an 
invoicing and sales reporting system. You'll find: 


® Money and Material Management 
® Useful dBASE II Utilities 

®@ Communicating with Clients 

® dbasics of Business 


@ Expense on the Go: A Portable Computer 
Application 


At only $19.95, this is an indispensable guide to office auto- 
mation and increased productivity! 


BUSINESS 


APPLICATIONS 
Tate ss TO ORDER: 
CALL TOLL FREE 800-533-4372 
(Mon-Fri, 8-5 Pacific Time) 
In Calif: 800-356-2002 
Or, return your order and payment to: 
M&T Publishing, 501 Galveston Dr., 
Redwood City, CA 94063 
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256K BYTES OF 
OOns STATIC MEMORY 


NO HIDDEN CHARGES! 


Performics prices include dynamic burn in 
and UPS 2nd day air delivery. 
* 128K byte version (depopulated 256K) $345 


STANDARD FEATURES 


100ns memory chips @ 24 bit addressing 

Operates in excess of 12 MHz @ Address strappable to any 128K block 
Certified system ready within the 16 meg address range 
(industrial grade dynamic burn in) Extremely low power consumption 
Supports 8 and 16 bit data transfers Single +5 volt operation 

IEEE 696/S-100 compatible One year warranty 


AVAILABLE SOON! High speed 


dynamic ram boards. 1 & 2 
megabyte densities at Performics 
realistic prices. 


Delivering high performance 
products and excellent service 
at realistic prices. 


(603) 881-8334 ORDER NOW! 
TERMS: Check, Visa/Mastercard 


Performics guarantees our boards will work in your system or return 
for full refund. 
11 Morning Dove Road @ Kingston, NH 03848 

@ Hudson, NH 03051 
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Hardware Review 


Communicating at 
9600 baud 


by Steve Bosak and John Sojak 


Several factors have made the ability to 
perform high-speed data transfer over 
standard analog phone lines increasingly 
important. While leased lines have been 
the preferred method, their cost and avail- 
ability limit the potential base of users. 
There are simply many more people who 
can benefit from high-speed data transfer 
than leased lines can accommodate. Re- 
searchers and scientists who wish to ex- 
change massive amounts of data over long 
distances have few choices when con- 
fronted with time-critical computations. 
Facsimile and CAD programs that require 
quick screen refreshes must currently put 
up with slow dial-up modem speeds to and 
from the remote. 

The next few years will see a change. A 
few 9600-bps dial-up modems are avail- 
able now, and more will be released in the 
coming months. The technologies used in 
these speed demons are impressive; the 
manufacturers have surmounted formida- 
ble communications obstacles to bring 
these products to market. 

This two-part article will discuss the 
protocols involved in high-speed commu- 
nications, in terms of both theory and im- 
plementation. This first installment covers 
representative modems from the CCITT 
Version 29 family, as well as Telebit’s pro- 
prietary protocol used in its TrailBlazer 
modem. All modems were tested over a 
period of weeks on standard dial-up long- 
distance lines. A description of V.32 fol- 
lows, as a comparison to the V.29 recom- 
mendations. V.32 modem evaluation and a 
more detailed discussion of V.32 recom- 
mendations will be presented in part two. 

The main drawback to communication 
over standard phone lines has always been 
the inconsistency of line quality. Even short 
haul lines vary widely. Operating in the 
telephone bandwidth of 200-3200 Hz, only 
middle bands are relatively reliable in qual- 
ity. As you move to the edges of the avail- 
able channel, distortion and noise increases. 
Low-speed modems have little problem 
confining themselves to the main part of 
the bandwidth. Generally speaking, the 
easiest way to attain higher speeds is to use 
a greater chunk of the available band or 
pack more data into the stable portions of 
the channel. Very high-speed modem 
transmission requires both methods. 
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A Review of Three 
High Speed Dial-up 
Modems—Part 1 


V.32 OPERATING PRINCIPLES 

The new 9600-bps modems fall into one of 
two categories: asymmetrical or sym- 
metrical (half or full duplex). In conven- 
tional, full-duplex 212A and 103 Bell mo- 
dems, the bandwidth is roughly split 
between two symmetrical channels, An- 
swer and Originate. Both modems have 
approximately equal chunks of the band- 
width to operate on. Continuing in this 
tradition, modems adhering to the Consul- 
tative Committee for Telegraph and Tele- 
phone (CCITT) V.32 recommendation for 
data communication have allocated sym- 
metrical channels to the answering and 
originating modems. As these channels 
are greedy for space to attain 9600-bps 
transmission rates, however, the two chan- 
nels completely overlap in the bandwidth. 
To assure the integrity of the data each 
modem must ignore its own transmis- 
sion—in effect, it tunes itself out. This 
echo cancellation can be accomplished 
with a great deal of accuracy over short 
distances or when the conditions of the line 
remain constant. Long-haul communica- 
tions compound the problem of echo can- 
cellation in that line quality and line- 
switching paths often change, causing 
erratic echo time rates. Therefore, mo- 
dems employing cancellation must be able 
to determine the echo dynamically and fil- 
ter it out of the stream without loss of the 
incoming data. 

While expanding the use of the avail- 
able bandwidth poses certain obstacles in 
design, the method of packing data into 
those channels is also tricky. The Bell 103 
modem offers the simplest example of bi- 
nary data transmission, one frequency or 
tone is transmitted for a one and another 
tone for a zero. To pack the data more 
densely, you must use further modulation. 


Moving from a pure frequency modula- 
tion scheme, high-speed modem manufac- 
turers have begun to encode the data by 
modulating the signal’s phase and ampli- 
tude. The effect is that each combination 
of signals then represents more bits of in- 
formation. Rather than having the on/off 
representation of frequency modulation, 
modems employing phase and amplitude 
modulation have more possible data 
states. This scheme, known as Quadrature 
Amplitude Modulation, or QAM, is al- 
ready in use on 2400-bps modems. To fur- 
ther pack the data and assure its integrity 
even beyond QAM, some V.32 9600-bps 
modems use an additional modulation 
known as Trellis Coded Modulation 
(TCM). In part two of this article, we will 
examine the use of both TCM and QAM in 
V.32 modems. 

The complexity of designing a full- 
duplex V.32 modem is enormous, and the 
V.32 modems that have been produced so 
far have price tags that reflect the sophis- 
ticated hardware required. British 
Telecom and Concord Data have intro- 
duced V.32s at around $3500. The V.32 
field is about to expand, however, with 
NEC America, Codex, and U.S. Robotics 
planning to introduce their own V.32s in 
mid to late summer. Representative mo- 
dems from the V.32 family will be evalu- 
ated in part two of this article. 


V.29 OPERATING PRINCIPLES 
The V.29 recommendation allows asym- 
metrical or half-duplex transmission at 
speeds of 9600-bps or higher. In an asym- 
metrical scheme, the bandwidth is carved 
out on demand. Most data communica- 
tions involve the transmission of large 
blocks of information in one direction or 
another—not both. Since the data and its 
speedy arrival is of importance, why not 
allocate most of the available bandwidth 
to whichever end needs to transmit that 
data? Essentially, that is what V.29 mo- 
dems do. When the modem determines 
that data is being sent in one direction, the 
majority of the bandwidth is turned over 
to the transmission, while a narrow por- 
tion is reserved for the receiver for house- 
keeping chores such as acknowledgement 
of received packets. 

There the similarities among V.29 mo- 
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Dr. Dobb’s Stands Apart 


Take a good, hard look at the crowded computer magazine 
market. If you’re a serious microcomputerist, one maga- 
zine stands apart. Dr. Dobb’s Journal. 


Dr. Dobb’s is not for everyone. It is written by and for 
expert programmers, and it’s the oldest and most techni- 
cally sophisticated microcomputer publication available. 
Since 1976, Dr. Dobb’s Journal has been the unchal- 
lenged leading source of software tools for advanced 
programmers. 


With the industry moving forward faster than ever, you 
need to stay a step ahead. Dr. Dobb’s sets the pace with: 


® regular columns on C, Unix, MS-DOS and 16-bit 
software; 


® algorithms and problem solving; 
® lively discussions of fundamental software issues; 


@ inside information on commercial languages and 
operating systems; 


® tips on advanced programming topics. 


The information and valuable code contained in Dr. 
Dobb’s makes each issue indispensable for serious com- 
puting professionals and enthusiasts. Don’t miss a single 
issue of this valuable resource. Subscribe today. If you 
aren't fully satisfied, cancel your subscription and keep the 
first issue as a free sample. 
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To start your subscription, 
fill out this coupon and return it to: 


Dr. Dobb’s Journal 
P.O. Box 27809, San Diego, CA 92128 


: Yes! Please enter my subscription for 12 issues of: 
: Dr. Dobb’s Journal for $25. 


If I am not fully satisfied I will write “cancel” on my sub- 
scription invoice and keep the first issue as a free sample. 


ENON a is 


Address. 


City. 


State. Zip 


@eeeeeeeoeeoeoeeeeeeoeeeeese 


70 Bill me later I've enclosed $25 Charge my (| VISA [| M/C 
e 
$ Card No. 


sd LO, ee 
eo 


e 
° Signature. 
e 


34 — — 3046 
$ Offer good in U.S. only Allow 6 to 12 weeks for delivery. 
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dems end. Although most employ QAM of 
one sort or another, manufacturers have 
superimposed their own error detection 
and correction (EDC) and, in some cases, 
added further compression schemes. As 
V.29 does not call for an exact type of 
QAM EDC, it has been left to the manufac- 
turers to determine the best way to assure 
data integrity. To give you an idea of the 
different varieties of QAM available, there 
are at least four versions of MNP, a QAM 
that also employs data compression, and 
one QAM based on CRC detection. 

Rather than reinventing the wheel at 
each company, many V.29 9600-bps mo- 
dem manufacturers rely on a modem chip- 
set produced by Rockwell International 
called the R96FAX. There are now a dozen 
or so companies that have taken advan- 
tage of the R96FAX board, because the 
chips implement V.29 with virtually no 


the market.” 


— Computer Shopper Magazine 


® Run your PC, XT or clone at 7.38 mhz. 
® 280% Speedup (Norton SI rating) 

® Speeds up all software — 

you can see the difference 

External speed switch 

External reset button 

Change speed “on the fly” 

Compatible with 8087 

Works with all color or mono displays 
“Slotless” plug-in on most PCs 
Includes: Selectable top speed, 
instructions, warranty, tool, 

remote mount switch, 

free BBS subscription 


$899 


PC-SPRINT 


“PC-Sprint is the most cost 
effective PC Speedup product on 


V20 add $10. Call for infor- 
mation on other products 


hardware overhead other than the board 
itself. By doing so, they can offer a V.2X 
modem at a reasonable price. 

The R96FAX communications engine 
designed by Rockwell was intended for 
facsimile document transmission applica- 
tions. The most limiting factor with any 
type of facsimile document transmission is 
simply the time it takes to move massive 
amounts of digital document pixel in- 
formation from one machine to another 
over conventional 3002 dial-up telephone 
lines. The characteristics of fax-type data 
are not unlike that of a typical information 
file. The silicon doesn’t know the differ- 
ence between bits produced by an optical 
scanner and the bits within a file. The 
Rockwell chip-set and board provided a 
cost-effective method of transferring in- 
formation while conforming to the CCITT 
transmission format. 


Exec-PC, Inc. 


P.O. Box 11268 Shorewood, WI 53211 


(4149) 242-2173 
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The R96FAX contains impressive sili- 
con. The board is about 4 X 2% inches 
and contains two 64-pin QUIP (quad 
inline), one 28-pin, and one 8-pin dual 
inline IC packages on it. The silicon imple- 
mentations are a digital signal processor, 
digital switched capacitor filter elements, 
and a proprietary analog processor chip. 
The more interesting features are a 
switched capacitor array used for a digi- 
tally tunable active filter, on-chip active 
cable equalization for both the transmit 
and receive data paths, and an automatic 
adaptive equalizer in the receive path that 
adjusts itself on the fly to compensate for 
poor line quality when in V.29 modes. The 
silicon itself will also generate and detect 
several types of discrete tones and has di- 
agnostic capability. The off-board support 
required is virtually any type of processor 
for error detection, data buffering, and ba- 
sic RS-232 DCE control. 

The R9600FAX modulation is a bit data 
stream phase shifted and amplitude mod- 
ulated on the carrier frequency. At 9600 
baud, there are 4-bit groups (QAM) repre- 
senting a 16-point “eye” if one were to 
view the signal on the line in the time do- 
main. With the V.29 protocol at 9600, the 
data stream is divided into four groups of 
two bits each impressed on the carrier fre- 
quency. At 7200, there are 3-bit groups 
(tribits) forming a 16-point structure. At 
4800, there are 2-bit groups (dibits) form- 
ing an 8-point structure that comprise the 
encoding. The board set is capable of 
CCITT V.29 (9600, 7200, 4800, 2400, and 
300 baud). The modem transmitter itself, 
exclusive of any support circuitry, is capa- 
ble of driving +5 dBM into a 600-ohm 
load and the receiver dynamic range is 
from 0-47 dBM. Typical bit-error rate 
over voice-grade dial-up lines at a 23 dB 
signal-to-noise ratio and 9600 baud is 10° 
in the V.29 mode. 


THE ELECTRONIC VAULTS UPTA 96 
The Electronic Vaults UPTA 96 utilizes 
the Rockwell R96FAX board as the data- 
communications engine controlled by an 
Intel 8051 family microcomputer. On 
board is 8K of static RAM and 8K of “pro- 
gram once” PROM for the operating firm- 
ware. The modem retails for $895. 

The design objectives of furnishing a 
functional V.29 data pump in a cost- 
effective manner were met well. The com- 
mand set is Hayes-compatible, with exten- 
sions to handle the V.29 protocol and some 
quirks inherent with 9600-bps asynchro- 
nous communications. The data block 
packing method is a header, then a block 
with an appended CRC16 for ARQ error 
detection on the receiver end. The modem 
will do dynamic rate adjustments of 9600, 
7200, 4800, 2400, 1200, and 300 baud de- 
pending on line quality. The heart of the 
UPTA is the Rockwell R96FAX modem, 
which is a powerful V.2X data pump for a 
dial-up line in its own right. 
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There is little need for much else in or- 
der to achieve a good V.2X 9600-baud data 
transfer. There are eight front-panel LED 
status indicators for TX and RX data, ring, 
carrier off hook, and so forth. The rear 
panel contains connectors for the usual 
DCE RS232 EIA, a modular RJI1 tele- 
phone connection for the phone line, an 
on/off switch, and DIN style connector for 
the external power supply. The mother- 
board is a conventional, two-sided G10 
glass epoxy board with good decoupling 
and bypassing. The RFAX board is 
piggybacked on the motherboard with 
standoff spacers. 


THE RACAL VADIC 9600VP 

The Racal-Vadic 9600VP, with a retail 
price of $1495, is also based on the Rock- 
well R96FAX modem. The 9600VP is con- 
trolled by a Z80B 8-bit microprocessor fam- 
ily chip-set, consisting of an SIO/2, CTC, 
and, of course, the Z80B processor itself. 
On board is 16K of static RAM and 2K of 
battery backup RAM for presets and li- 
brary storage. The operating firmware is 
contained in a 32K EPROM. The Z80 takes 
care of housekeeping, data compression, er- 
ror detection, and data correction, while 
the actual task of line transfer is taken care 
of by the Rockwell board. At 6 MHz, the 
combination of the Z80B and the SIO is an 
excellent choice for modem control. 

Some of the unique aspects of the 
9600VP are transparent data compression 
and error correction. The 9600VP typically 
will reduce the physical size of an ASCII 
text file from 20 to 60 percent, making a 
typical packet sent by the modem smaller, 
bettering the effective throughput over a 
straight byte-for-byte transfer. The inter- 
nal transparent error correction Racal em- 
ploys, called MNP, will minimize the num- 
ber of retransmitted blocks. Not all errors 
are correctable, but if several bits can be 
corrected locally, the overhead of re- 
transmitting the entire block will be saved. 
MNP, in effect, can correct mistrans- 
mitted blocks by reevaluating the block 
sent against the coded QAM. If correction 
is impossible locally, the receiving modem 
requests a retransmission. The 9600VP, 
like most other RFAX-based 9600 mo- 
dems, will also adjust its communications 
rate dynamically to compensate for 
phone-line quality in a fall-back and fall- 
ahead fashion. The modem monitors call 
progress tones for no answer, busy, reor- 
der, and so forth. 

There is a complete complement of 
front-panel LED status indicators, 4 la 
Hayes, indicating data and control status. 
In addition, there is a membrane keyboard 
on the front panel to control the voice/ 
data, loopback, and dialing functions, in 
conjunction with the usual AT commands. 
Most of these key switches have status 
LEDs embedded under a translucent view- 
ing area. 
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The rear panel contains the standard 
DCE configuration EIA connector and two 
RJ11 modular telephone connectors—one 
for the line, the other for a phone. Power is 
supplied via a DIN-style connector and an 
external power supply. The motherboard 
is multilayered. The RFAX board is piggy- 
backed on the motherboard with standoff 
spacers. The mechanical assembly is su- 
perb, with machine-tool sockets on the 
critical components. These are high- 
quality sockets with superior extraction 
resistance. The modem is capable of Bell 
103 and 212A transmission, with auto- 
matic detection of either. 


THE TELEBIT TRAILBLAZER RA12E-T1 
If V.29 and V.32 were not enough to crowd 
the possibilities of moving data at 9600- 
bps, Telebit manufactures a modem with 
its own proprietary protocol called PEP 


(Packetized Ensemble Protocol). Although 
it too is an asymmetrically designed mo- 
dem, it does not follow CCITT recommen- 
dations. Telebit TrailBlazer RA12E-T1 
Packetized Ensemble modem is a complete 
departure from the R96FAX-type devices. 
It is a complete departure from V.2X proto- 
col altogether. The modem represents a 
good cross section of state-of-the-art silicon 
devices that can be put together to do 
upper-middle to lower-high-end digital sig- 
nal processing in real time. On board is a 
16-bit Motorola 68000 processor and a 16- 
bit Texas Instruments TMS32010 Digital 
Signal Processor. There are also two hy- 
brid, custom, surface-mounted 8K X 16 
RAM modules. It looks as if one is for the 
68000, the other for the 32010. 

Firmware for the 68000 is contained in 
two 32K X 8 PROMs of space for the op- 
erating system. The signal-processor firm- 


¢ Z Best Sellers - 


Z-COM (7 disks) $119.00 
Easy auto-installation complete Z-System for virtually any Z80 
computer presently running CP/M 2.2. In minutes you can be 
running ZOPR3 and ZRDOS on your machine, enjoying the vast 
benefits. Includes 70+ utility programs and ZCPR3: The Manual. 


Z-Tools (4 disks) $150.00 
A bundle of software tools individually priced at $260 total. Includes 
the ZAS Macro Assembler, ZDM debuggers, REVAS4 disassembler, 
and ITOZ/ZTOI source code converters. HD64180 support. 


PUBLIC ZRDOS (1 disk) $59.50* 
If you have acquired ZCPRS for your Z80-compatible system and want 
to upgrade to full Z-System, all you need is ZRDOS. ZRDOS features 
elimination of control-C after disk change, public directories, faster 
execution than CP/M, archive status for easy backup, and more! 


TERM Ill (6 disks) $99.00* 
TERM III has been called "a cosmos". Why? Because it's 29 programs, 
featuring TSMASTER and T3SERVER, are galactic in scope. KERMIT, 
XMODEM, 1k XMODEM, and batch YMODEM protocols supported. 


DSD (1 disk) $129.95 
The premier debugger for your 8080, Z80, or HD64180 systems. Full 
screen, with windows for RAM, code listing, registers, and stack. We 
feature ZCPR8 versions of this professional debugger. 


Quick Task (3 disks) 


$249.00 
Z80/HD64180 multitasking realtime executive for embedded com- 
puter applications. Full source code, no run time fees, site license for 
development. Comparable to systems from $2000 to $40,000! 
Request our free Q-T Demonstration Program. 


*ZCPR3 required. 


Echelon, Inc. 


885 N. San Antonio Road « Los Altos, CA 94022 
415/948-3820 (Order line and tech support) 


Z-System OEM inquiries invited. 
Visa/Mastercard accepted. Add $4.00 
shipping/handling in North America, 
actual cost elsewhere. 

Specify disk format. 
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ware is contained in two of what appear to 
be 4K X 8 devices, making a total of 4K 
available for the digital signal processor 
firmware. There is an incredible amount of 
processing horsepower between these two 
devices. Telebit has defined a new ap- 
proach to high-speed communications. 
What happens here is that the DSP (digital 
signal processor) implements a Fast Fou- 
rier Transform on the phone line, breaking 
it into 512 channels of 7.8 Hz segments and 
determining what the signal-to-noise ratio 
and loss for each segment is. Each channel 
is then either used for data or, if it is deter- 
mined to be a troublemaker, digitally fil- 
tered out on the receiver. Typically, 400 or 
so channels are active during any session. 

Three types of modulation techniques 
are used: 2-, 4-, and 6-bit QAM. An effec- 
tive communication rate is determined for 
each channel, and it is either filtered out 
altogether, or given 2-bit QAM, 4-bit 
QAM, or 6-bit QAM. For idle and, for ex- 
ample, console-to-console conversations, 
the modem will send 23-millisecond dura- 
tion packets. If the 23-ms packet begins to 
fill up, the modem will switch to 136-ms 
packets. There is no error correction at all, 
but a selective retransmission of packets 
with errors. If multiple errors are deter- 
mined, the firmware will recalibrate all 
over again to determine which channels 
are now good and which have gone sour. 
This takes just a fraction of a second. The 
TrailBlazer monitors call progress tones 
and has a speaker for connection progress. 
The single PC board is peppered with dis- 
crete “glue” chips, about 30 RAM and 
PROM, exclusive of the processors. The 
power supply is built to handle the require- 
ments of the modem, with 3 watts being 
generated as heat. 

There is an unusual but necessary fan in 
the rear corner to provide forced air cir- 
culation. It is quiet and would not pose any 
type of problem in a typical office environ- 
ment. There has been substantial attention 
paid to detail in the mechanical assembly. 
For example, there are two ferrite-core, 
wirewound, torrid filters in the power sup- 
ply that have been placed in a small plastic 
box mounted to the PC board. Most filters 
of this type are glued to the board with sili- 
cone rubber adhesive. The front panel has 
the usual status LEDs, and there is a power 
switch on the right-hand side toward the 
front. The rear panel has the DCE configu- 
ration EIA connector, two RJ11 telephone 
type connectors, and an interlocked post- 
power connector for the remote supply. 
TrailBlazer also incorporates Bell 212A 


and 103, v.22 and V.22-bis 
emulation. 
TESTING THE MODEMS 


In testing the performance of the 9600VP, 
UPTA 96, and TrailBlazer, we transmitted 
straight ASCII text files of 196,096 bytes 
over a typical long-distance phone line. 
The text file was checked for integrity at 
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sending and receiving ends by CRC file 
checks and with DOS utility file compares. 
Two methods of software transfer were 
employed. The initial tests were straight, 
nonprotocol ASCII dumps with the MEX- 
PC communications program. More ex- 
haustive testing was performed with 
Crosstalk XVI Fast Version 1.6 software, 
set to the hardware manufacturers’ speci- 
fications. Bit-transfer rates were deter- 
mined by 196,096 bytes X 10 to deter- 
mine bits, divided by the transfer time in 
seconds. Hard disk access time was 
clocked and subtracted from the transfer 
time, giving the essential throughput, in- 
cluding handshaking, EDC, and turn- 
around time. Retransmission of packets 
was included in the timed tests. The re- 
sults are shown in Tables 1-4 in the 
sidebar. 

It should be noted that these modems 
are not designed for interactive or con- 
versational modes. If terminal-to-terminal 
communication is desired, the operators 
would do well to switch to the modem’s 
more conventional 103 or 212A speeds. 
The high speeds are primarily for facsim- 
ile and data transfer. Slow character echo 
will have to be tolerated at the higher 
speeds when typing back and forth be- 
tween terminals. The lower speeds in the 
Racal-Vadic include 300 and 1200-bps, 
using standard 103 and 212A hardware 
chips; we found both to operate smoothly 
and without trouble. The Telebit’s lower 
speeds—1200 and 2400—are emulated by 
the existing hardware. This emulation was 
tricky, at best, to run successfully. We had 
severe problems getting the TrailBlazer to 
talk to either a Hayes 2400 or USR Cou- 
rier 2400 in the TrailBlazer Version 22 or 
Version 22 bis modes. The UPTA 96 we 
tested had no low-speed transmission; 
however, the latest version of the 96 can 
include 300-, 1200-, and 2400-bps rates 
via snap-on chip-sets to the 96’s current 
board. Like the Racal-Vadic, these are 
true 103, 212A, and V.22-bis modems uti- 
lizing industry standard Rockwell chip- 
sets. 


SETTING UP AND USING THE MODEMS 
By far the most difficult modem to get up 
and running for tests was the Racal 
9600VP. The number of registers that had 
to be set for software purposes was a tad 
bewildering. To be fair, this register set is 
extensive, and provides the user with re- 
markable flexibility in configuration. Syn- 
chronous and the 212A asynchronous 
modes in one modem would almost dictate 
that some registers be user-selectable. Av- 
eraging our test results on the 9600VP, the 
throughput of the Racal was 5.609k-bps, 
indicating the modem had fallen back to 
the 7200-bps mode. Both 16- and 255- 
block-size transfers were used. 

The UPTA 96 was the easiest of the mo- 
dems to configure and begin transfers 
with. Even with two and three retrans- 
missions of faulty blocks in two of the 


transfers, the UPTA turned in a respect- 
able 6.167k-bps, using the manufacturer’s 
recommended block size of 16. The Trail- 
Blazer did indeed live up to its moniker— 
with blocksizes of 255, the modem 
screamed in over the line at 7.971k-bps. 

To be sure, the effective rates are deter- 
mined by line quality in real time. Line 
analysis was available, but we deemed it 
inconclusive—quality can change dra- 
matically at any given point, bursts and 
line hits can occur at any time during a 
transmission. Therefore, care was taken to 
evaluate the modems over many days and 
during various times of the day. The dis- 
crepancy between the UPTA 96 and the 
Racal-Vadic 9600VP can probably be ac- 
counted for in terms of variants in the line 
noise. The significant speed difference be- 
tween the UPTA 96, the 9600VP, and the 
TrailBlazer can only be accounted for by 
modem design, however. That kind of a 
speed gap must indicate a superior design 
and transfer method. 


SOFTWARE 

Theoretically, any software package that 
allows nonprotocol file transfers and serial 
port settings to at least 9600-bps should be 
able to handle these modems—or should 
we say, the modems will handle the soft- 
ware. The less interference with the mo- 
dem’s transmission, the better. We found 
that a straight ASCII file transfer, no 
handshaking, ran the smoothest. In MEX- 
PC we merely called for a straight ASCII 
dump from the terminal mode. Blanking 
or quieting the screen writes with MEX’s 
QUIET command gave a marginally faster 
throughput than an ASCII transfer in 
which the data was painted to the screen in 
addition to a capture buffer. 

All the modems ran with a minimum of 
effort in these straight ASCII dumps, and 
any software that will allow a hands-off 
transmission will no doubt work. Due to 
the modems’ internal error detection and 
correction, straight dumps of binary files 
should pose no problems. We experienced 
some difficulty with the Crosstalk-Fast 
software, particularly with the Racal- 
Vadic and TrailBlazer. To be fair, Cross- 
talk was not a recommended package for 
the 9600VP. In the case of the Racal- 
Vadic, we had to find an acceptable block 
size. The TrailBlazer quieted down once 
we set the serial port speed to 19.2k and 
the modem was allowed to wail at full 
speed. Again, the less active the software 
during transfers, the better. 

We did marginal tests with QMODEM 
and Procomm 2.3. Throughput with the 
various software was similar for each mo- 
dem tested; for instance, an ASCII dump 
via MEX and a Crosstalk transfer with the 
TrailBlazer had only minor bps speed dif- 
ferences—not enough to call statistically 
significant. Again, this should come as no 
surprise, as the modem is handling all er- 
ror detection and correction; the software 
merely facilitates dial up and assists in a 
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control of PC software was too much trouble. 


My department They said that putting data processing in 


took all the 


Software piracy is a Federal crime. At ADAPSO, the computer software 
and services industry association, we’re working to help data processing 
managers like you prevent the problem. And to help your company 
avoid substantial fines and legal fees. 

You can help top management protect your company by actively 
discouraging software piracy. ADAPSO can provide you with sample 
policy statements and free booklets for company employees. 

Just return the coupon. It could put you back in control. And it might 
keep your department off the hook. 


bh Then people started copying software. When we 
Arne were sued, guess where the fingers pointed. 


r_-—__—_--_--_-_-_-_-_-_-- 


| Send this coupon or your business card for more information 
Or call us at (703) 522-5055 and ask for Muriel. 

ADAPSO, 1300 North Seventeenth Street, Arlington, 
| Virginia 22209 


ADDRESS 


4 
| 
| 
| 

| 

NAME TITLE | 

| | 
| Cowan | 
| | 
| 

alk 


A Software Piracy is a Federal Crime 


800-528-3138 Orders Only 


PRINTERS & BUFFERS 


M-1109 100-25 CPS, P&S TRACTOR........... $189 
M-1509 180/45 CPS, P&S, W/TRAC............ CALL 
M-1409 AS ABOVE B/W 110 CO., 

BAAR ceccavscssssascuislvssastzanstcresnscssentenousecsresoeiets CALL 


M-1709 240/50 CPS, “PAPER PARK” 
FX-286 & IBM PROPRINTER COMPAST, ... CALL 
HR-35 36CPS DAISY, WIDE CARR ........... $729 


HR-20 20 CPS. ...cccsecceessessusssescvessneenees 
HR-15XL 17 CPS DAISY WHEEL 

CITIZEN MSP-10.. $309 MPS-15.. $429 
CITIZEN MSP-20 .. $349 MPS-25.. $499 


CORDATA LP-300 LASER WITH FORM EASY 
300 x 300 RES /s PG GRAPHICG.............. $2,089 
CORDATA LP-300 XL LASER 

300 x 300 RES % PG. GRAPHICS 


WIFORMCEASY ...........:sccsssestssseeesseeesseseseees os 719 


HANZON LP3000+ LASER W/ HP GL 
PLOTTER COMMANDG.........ccssesescsesesseenees Cc 
STAR MICRONICS SA-15.............. 
TOSHIBA P3271 PARA & SERIAL 
TOSHIBA P3417 .......csssscsssseesssseeseeeees 


TOSHIBA P3571 PARA & SERIAL .... 
OKIDATA 


XEROX Diablo 


ine COB ocsccicssiaticees $815 
S4LQ cesses $939 


Yohax 


PERSONAL SPEECH SYSTEM................... $295 


POWER SYSTEMS & ACCESS 


(ca COMPUTER ACCESSORIES 


ALL CABLEG...................... Call for Lg Discount! 
$4 4 CIRCUIT SURGE SUPPRESSOR .......... $19 
$10 6 CIRCUIT SURGE SUPPRESSOR ........ $29 
P15 5 CIRCUIT MONITOR BASE 

WITH MODEM PROTECTION ...........ccccceee0e2 $98 
U1000 POWER SAVER, (TOPAZ) 

WITRUE “SINE” WAVE ...........00:scsesssessssesee CALL 


BC-425 WATT S.P.S. 30 MIN 
BC475 WATT S.P.S. 70 MIN.... — 
BC-1000 WATT 40 MIN.........ccessesseeseseeeeseeee 
SAFE (SAFT) SPS1000 WATT 

SINE WAY Bssccsciesssteccisccncsncctscorasscstesrecesscsia $949 


PROMODEM 1200G ....... $179; 2400G........ $339 


PROMODEM 300C APPLE IIC...............0000. $65 
Multi lech@ 

MT224EH MNP ERROR CORREC.............. $529 

MT224ER RACK MOUNT W/EDC ............... $495 


All merchandise new. Advertised prices are cash prepaid only. AM. Express - add 5% 


CTS 224ADH HAYES COMPATIBLE.......... $295 
HAYES-ALL MODEMG...............c00000s0000000 CALL 
U.S. ROBOTICS BLOW-OUT ..............:000 CALL 
MONITORS & TERMINALS 
NEC MULTISYING.. ..cecssrsvesssissorssosessersevsnesis CALL 
TECMAR AGB HI-RES ZVM-1360 ...........-+++ $498 
ZENITH ZVM-1240 (IBM) FLAT SCRN........ $149 
PRINCETON GRAPHICG....................c:00000 CALL 
© TATUNG 

CM-1360 6450x200 RGB, 13”, G/A SW....... $339 
CM-1380F EGA 640x350 RES 256K............. $450 
TEGA- 22 256K EGA 2 CARD.........::cceesse00e2 $245 
1422A DUAL FREQ. TILT/SWIVEL, 

14” GREEN/JAMBER sisssivcssocssssviececcccusvessacens $139 


LINK 125 EMUL WY-50 ETC., HI-RES 
14” GREEN, 6 SCROLL RATES, IBM SELEC, 


K.B. 1 YEAR WARRANTY .........cceseseesesesseees $36 
PC-TERM EMUL WY-5O, TVI925, IBM-AT 
KB, GOOD FOR PC-SLV BDS......csssssseseseeeee $41 


XEROX TELECOPIER* 
7010 TERMINAL 


Don't settle for just a 
facsimile! 

1 Send and receive a copy in 
less than 30 seconds 
Distribution-quality Copies 
Automatic Document 
Feeder: 10 originals 
40-digit Operator Display 
ead Sroups 


oes $1 695 


XEROX®, TELECOPIER® and the identifying 
numbers herein are trademarks of XEROX 
CORPORATION. 


SOFTWARE 


We sell all well known brands. Order correctly 
— OPENED SOFTWARE IS NOT RETURN- 
ABLE! 


NEWSTAR NEWWORD 2..........cccssesesseseeeeees 
NEWSTAR NEWWORD Q.............. a 
BD SOFTWARE C COMPILER 8”. 
MICROSOFT * ASHTON-TATE................. - 


MICROPRO * MULTIMATE * PF6S.............. 45% 
BORLAND TURBO PASCAL, ETC...... "45% 
MOST OTHER PC PROGRAMG.......... . 45% 


CALL FOR DEALER PRICING, INTEGRATION, 
AND/OR CONSULTATION. 


COMPUPRO NET 100..........s.ssssessssessesseseeseee $369 
PC-SLAVE/16 1MB, 8MHZ, V20..........:02000++ $655 
RTNX MSDOS 2.1 ........cssssseseseseseeee --- $109 
ATNX MSDOS 3.1 .. - $189 
NTNX MSDOS 311 0.0... eee eeeesesessseeeeeseeeeeeeees $295 


EARTHNET-P.C. ARCNET HALF CARD..... $259 


WNOVELL 


ADVANCED NETWARE STARTER KITS, 


SERVERS, AND SOFTWARE....................- CALL 
CABINETS 

MPS 10005 6 SLOTS 3HH DRVG..........2::00+ $395 

MPS 5407 HARD DISK FH OR 2HH............ $195 

JMR 7H5 PC-STYLE FH OR 2 HH 

HARD DISK DRIVE isi. scssesstescsccssereccccscccateosess $185 

INTEGRAND 2975 DUAL HORIZ. FH 

HARD DISK DRIVE ..........s:scssssersercseseeteeeeseees $199 

INTEGRAND 800 AD/15 15 SLOTS 

Z HARD DISK (5°) wicssissccsscsosssseecsvesossswessessceess $440 

INTEGRAND LASER 3310 4 SLOTS, 

2 HARD DISK (8”)......eseseseseseseseseseescecesseseaneees $387 

PARA DYNAMICS 3020D 20 SLOT 

DESK TWOP wccsesciesasssstesseisctsesscstcateeoesaaveestiaine $595 

PARA DYNAMICS 2300-G35” HD 

& 2X8 FLOPPY .....cscsssessssssssessesssssesecessssnsseseees $339 

PARA DYNAMICS 5820-S 58 AMPS, 

20 SLOTS, MANY DRIVES..........:seseseseses $1,795 


HARD DISK SYSTEMS 


40MB Q540 W/DISK 3, CABINET, 


CABLES, ETC. FOR COMPUPRO............ $1,575 

80MB MC-1325 FOR COMPUPRO............ $1,795 

COMPUPRO DRIVE ENCL., DISK 3, 

QUANTUM Q540, 5” & 8” FLPYS ............ $2,395 
DRIVES 


SEAGATE ST-225 20 MB, 65mSEC............. pelt 
QUANTUM Q540 40MB, 45mSEC : 

QUANTUM Q540 REFURB 1 YR....... zs 
SEAGATE 4057 50MB, 40mSEC................. $789 | 
MICROPOLIS 1325 85MB, 28mSEC.......... $1,295 
MAXTOR XT-1140 140MB, 30mSEC......... $3,195 
ALLOY 17.7MB TAPE SUBSYS..........0100+ $1,595 
IRWIN 70MB TAPE (CDOS4, 1/CPRO)........ $369 


.MC, Visa & P.O's from 


qualified firms - add 3%. Wires, COD's ($5 min. fee) with Cashiers Check/MO & APO's accepted. Shipping 


minimum $4 first 3 Ibs. Tax: AZ RES ONLY add 6%% sales tax. All returns subject to 20% restocking fee or 


credit towards future purchases. All prices subject to change without notice 
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When Our Ad Says “Call”, 


We Will Not Be Undersold! 


S-100 BUS PRODUCTS INDUSTRIAL COMPUTER DESIGNS oh 


( ompuPro 


We will integrate a system of some or 


all COMPUPro COMPONENNKG.............0:-eseseseseseeeseees 
“HAVE SPECS WILL QUOTE!” 

YSU OI ONG? os cssnccvsensaresssonsacosssceserascane $7,279 
CPU286 8BMHZ 3 CYCLE .u....essesseeseeseeseensene $509 
CPU286 8MHZ, 2 CYCLE.. we. $655 
CRUZ SMZ 280 isis cscsiccscsasscscsccssnecnsissssnscssuses $199 
CPU 8085/88 6/10MHZ...... + $255 
CPU 8086 10MHZ..............-:cecsesseceeeeeee $288 


SPUZ 256K, 8MHZ, UP TO 4 USERS... 


SP186 10MHZ, 512K RAM SLAVE....... 

MDRIVEJH 512K... eesseseeseesesseneene - $363 
MDRIVE/H 2MB...........essessssesssssssesssesssssensenees $800 
RAM 23 64K....... $180 RAM 23 128K....... $255 
RAM 22 256K STATIC.........sessesssssessssseesseseees $435 


INTERFACER 4 3 SERIAL/1 PARAL... 
DISK 1A5” & 8” FLPY CTRL..........000 
DISK 3 ST-506 H.D. CTRL.......... 
ENCLOSURE/2-DESK 21 SLOT... 
ENCLOSURE/2-RACK 21 SLOT.. 


DRIVE ENCLOSURE-DESK...... $508 
DRIVE ENCLOSURE-RACK.. . $655 
PC VIDEO BOARD.................. .. $362 
IN NO scr sssccccccsnscassesessivacaassesvesstadteencsasstetes $369 
HYBRID HUB......$255 PASSIVE HUB...... $47 
SYSTEM SUPPORT 1... esesessssesesseeseentenes $292 
CONCURRENT DOS 4.10D..... $4.95 
CONCURRENT DOS 4.1E..............:000 w+ $635 
CPM/816.............. $255 CP/M80.............. $182 


COMPUPRO DISK DRIVE BRACKETG......... $25 


MACROTECH INTERNATIONAL CORP. fai 


MI-286 80286, 8MHZ, 2-CYCL & Z80H, 
A “DROP-IN“ REPLACEMENT FOR 


ADIT INTELLIGENT 8 PORT SERIAL...... 
AMADIT-8 FOR ALPHA MICRO SY6.......... $959 


Let us Integrate a system per your specs! Ask 
about our stylish 6 slot 1.5 drive cabinet. 
THUNDER + 8MHZ 80186, 512K RAM,2S, P, 
FLPY CTRAL, CDOS 4.1 -LITERALLY A 


SYSTEM ON A BOARD ecccscsccssssscsesssssvsesee 95 
THUNDER + 10MHZ 80186, 1MB RAM, 
ET CKAS ABOVE \icsissssccscannsansssssscascscsusesassae 095 


LIGHTNING 286 8MHZ CPU...........c:sssseeeee $819 
LIGHTNING 286 10MHZ 80286 CPU.......... 

CONTROL-IT-LL H.D.&FLPY CTRL... 
HAZITALL 25S, 2 P, CLOCK .........s:0000 


MEGARAM 512K DRAM........ Scie 
MEGARAM 1MB DRAMM...........cssscsssseeseenees $ 
MEGA-S-RAM 16K-1MB STATIC RAM 
OCTAPORT 8 PORT SERIAL.........-...sseseee $ 
NV-DISK SOLID STATE 2MB DISK. : 


CDOS 4.1 MULTI-USER.........escessessssseessessees 
COLOR MAGIC S-100 BUS PC COLOR 
GRAPHICS EMULATOR FOR BUG............. $445 


S-100 DIV./696 CORP. 


14455 NORTH 79th ST. 
SCOTTSDALE, AZ 85260 . 


CCT-100 CLOCK TIMER 


CPZ48004 MASTER: 4MHZ Z80, 64K 
2S, 2P, FLPY, 8&16 BIT MEMORY OR oO a 


MAPPED APPLICATIONS ...........cscsssseeseseeee 5 
CPS-B8A SLAVE: 8MHZ Z80, 

N2BKG Pi 2S sssivicscasveas ccssensssisvassesasevsntessseaneisseis $469 
CPZ-186 MASTER: 8MHZ, 1MB RAM, 

2S, WILL RUN 8 ANDIOR 16 BIT 
APPLICATIONS AND SLAVES ....scsssssssee $1,196 
CPS-16 SLAVE: 8MHZ 8086, 

Z5OGCK:. RAM, 25, P  ssessnssvssssscssscseccsvseassotessaacies 9 


CPS-216 DUAL SLAVE: 

BMHZ 8086 & 512K..........ceeseseseseeeseseseenseeees $1,269 
OMTI-5300HD & TAPE CTRL 

CONNECTS WITH SCSI PORTION 


MASTER, MOUNTS ON DRIVE.............000 $519 
LANS-100 ARCNET CONTROLLER........... $349 
LAN-PC ARCNET CONTROLLER 

(WORKS WITH NOVELL).........:cccseeseseeeeeees $349 


SUAL. 


VMPU-32 PROCESSOR 68020 

16 MHZ, 1MB RAM, CLOCK, BATT, 
PAGED MEMORY MGMT 
VSMD CACHING SMD 3 DRV.CTRL....... 
VMEM 2MB, 85mSEC ACCESS. .............. 
V9TRK 9-TRK TAPE CTRL, 6250 BPI 
VIOP VO CPU, 10MHZ 6800, 512K........... 

10-S8 8 SERIAL UP TO 84.4K BAUD........... $397 
SCM SYS CONTROL MODULE, 16 MHZ... $397 
VMBD-12 12 SLOT BACKPLANE ................ $669 


APPLE PRODUCTS 


M-1109AP 100 CPS 
WIALL CABLEG........:ccecscsssssessessseseceseenenceeees $239 


i, ProModem 1200from... 


300C MODEM FOR IIC - FITS ON BACK 
OF COMPUTER AND YOU DON’T LOSE 
YOUR SERIAL PORT .......sccesseseseseseseststeeeeeeeee $65 


PRACTICAL PERIPHERALS 


PRO CLOCK cscisssszscscsscscsscsseasccsssssssacsorsesasesiness 
PRINTER FACE aes 
GRAPHI CARD...... ion 
SERIALL .....0.0......cssssssssesseseesssesseceeceesseneeecseesees 


EVERYONE'S PHONING HOME 
ABOUT THIS ADVANCED "AT" 
COMPATIBLE SYSTEM 


“ET-286” BASIC SYSTEM 


12MHZ ONE WAIT STATE OR 10MHZ NO 
WAIT STATE SPECIAL ORDER - ALLOW 5 
WEEKS, 10 & 6 MHZ 80286 CPU ONE WAIT 
STATE, 1 - 4MB RAM ON MOTHER BOARD 
ALSO ON MOTHERBOARD: 

¢ 6 AT COMPATIBLE SLOTS 

e 2 XT COMPATIBLE SLOTS 

° hie OR RS422 SWITCHABLE SERIAL 
e¢ 2 CENTRONICS PARALLEL PORTS 

e¢ CLOCK/CALENDAR WI/BATTERY BACK-UP 
© 100% IBM-AT COMPATIBLE BIOS 

¢ CABINET, 200 WATT PIS, & KEYBD..... $1,395 


OPTIONS TO COMPLETE YOUR 

“STATE OF THE ART” SYSTEM: 
FLOPPY-HARD DISK 16 BIT CTRL 
1.2, MB FLOPPY DRIVE..........e:0:sesecer00 
26MB 65mSEC HARD DISK DRIVE.... 
51MB 35mSEC HARD DISK DRIVE 
85MB 28mSEC HARD DISK DRIVE 
140MB 30mSEC HARD DISK DRIVE....... $3,319 
20-60MB (2MB/MIN.) TAPE BACK-UP......... $707 


TATUNG TEGA-22 DUAL FREQ, 


256K RAM .j:...cescesesssssessssseseserscsseoteesscesececeenees $259 
TATUNG CM-1380F 13” ENHANCED DUAL 
FREQ. RGB MONITOR WI/G8A SW........00 $450 
TATUNG PRIVATE LABELS 

IBM & MICROAGE MONITORG...........::0000 CALL 
TATUNG 1422A DUAL FREQ. TILT 

‘N’ SWIVEL AMB/GRN 14” 640x400........... $139 
MACROTECH MSR-AT 12MHZ, 0-3MB 

RAM, NO WAIT STATES........c:sesscsseees $185-$625 
NEC 1407 MULTISYNC 

PC-DOS 3.2 .......secsessscessesteseeseeees 

XENIX OPERATING SYSTEM 


$ 
LINK 125 GRN 14” TERMINAL, 1 YR WARR, 
WY-50"LOOK-ALIKE™ ... crervcnecoracssesseesasaseses $379 
ALLOY PC-SLAVE/16 8MHZ 8088 


1MB RAM PER USER. ..........csssessesessesssesseeees $655 
ALLOY ATNX NETWORKING 

SOFTWARE, UP TO 31 USERG............1.00+0 $189 
AUTO CAD ADE-O .....cecsessccssesesssssssesescersenees $259 


800-528-3138 Orders Only 


602-991-7870 Customer Support 
TELEX 9103806778 SONE HUND 
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minor way with initial handshaking and 
the setting of the serial-port speed. 


LOOKING TO THE FUTURE 

The V.32s will be on the shelves shortly, if 
manufacturers’ promises can be taken se- 
riously. Due to the complexity of V.32 rec- 
ommendations, the designs will be more 
expensive than their V.29 cousins. The 
rigid nature of V.32 recommendations re- 
garding EDC, though, should make them 
compatible with each other. Compatibility 
between V.29 modems is not possible now, 
as each manufacturer is striving to get his 
EDC protocol more widely accepted. Add 
to that fray the proprietary Packetized 
Ensemble Protocol of the TrailBlazer, and 
you have a slugfest of major proportions 
over whose high-speed method will reign 
supreme. Part two of this review will con- 
tain evaluations of V.32 9600 baud 
modems.§ 


PRODUCT INFORMATION 


UPTA 96 

V.29 9600, 7200, 4800-bps 

Price: $895 

Snap-in 103, 212A and V.24-bis modem 
components. 

Recommended Software: MEX-PC, 
Crosstalk-Fast, BLAST, Respond, Relay 
Gold, Carbon-Copy, Q-MODEM, 
Professional-YAM. Call manufacturer for 
mini-to-mini, PC-to-mainframe, and 
other software needs. 

Electronic Vaults, Inc. 

12347-E Sunrise Valley Dr. 

Reston, VA 22091 

(703) 620-3900 


Racal-Vadic 9600VP 

V.29 9600, 7200, and 4800 with 103 and 
212A asyncronous modes 

Price: $1495 

Recommended software: George (from 
Racal-Vadic), call manufacturer about 
other PC-to-PC software or PC to 
mainframe and mini software packages. 
Racal-Vadic 

1525 McCarthy Blvd. 

Milpitas, CA 95035 

(800) CALL-VADIC 


Telebit TrailBlazer RA12E-T1 
9600+, V.22, V.22-bis, 103 and 212A 
emulation 

Price: $2300 

Recommended software: MEX-PC, 
Crosstalk-Fast, BLAST, Carbon Copy, 
Relay Gold, Respond. 

Telebit Corp. 

10440 Bubb Rd. 

Cupertino, CA 95014 

(408) 996-8000 
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bps transmission 
including turnaround 


Modem 
Racal-Vadic 9600VP 5.609k 
EVI UPTA 96 6.167k 
Telebit TrailBlazer 7.971k 


Table 1. Modem throughput with 196k ASCII file 


Modem Time in milliseconds 
Racal-Vadic 9600VP_ NA * 

EVI UPTA 96 253 ms 

Telebit TrailBlazer 136 ms 


Table 2. Turnaround times, transmission mode 


Modem Time in seconds 
Racal-Vadic 9600VP 2.5 
EVI UPTA 96 3.5 


Telebit TrailBlazer 1.5 


Table 3. Turnaround, interactive mode 


Modem Retransmission 
Racal-Vadic 9600VP 4.0 
EVI UPTA 96 3.5 


Telebit TrailBlazer 2.5 


Table 4. Retries, retransmissions per 196k transfer (average) 


Note: turnaround times in interactive mode were timed at the keyboard. 
* The transmission turnarounds are manufacturer supplied. 


Retransmissions were averaged from Crosstalk-Fast transfers after software 
and modem were fully prepared and operational.) 


ONE COMPUTER & 
TWO PRINTERS? 


56595 

Stop Plugging a“ F». Plus $3.25 

& Unplugging! Shipping 

use your choice of TWO. : 

printers from ONE 

parallel cable with the 3 : 30 Day 

simple flick of a switch. e Money Back 
Guarantee 
Model #2100 

One Parallel Plug In... Two Parallel Plugs Out! 


Connect any Standard Centronics Parallel Cable directly to 
the switch. Two 3!4' cables (included) attach to each printer. 


Simply Call 1-800-TO-ASK-US! 8am-5 pm PST 
800-862-7587 
(CA 415/567-4067) 


To Order: Write or call Tipz Direct, Inc. Visa/MC or 
Money Orders please. Shipping within 48 hrs. via UPS. 


Offering a FULL LINE of 
Switches, Cables, & ene (1 \ 
P.O. Box 690, 

San Francisco, CA 94101-0690 MSJ-210 


S$-100 
BARE BOARDS 


8086/8087 CPU - plus 
2764 or 27128, 8253, 8259 


8088 Auxiliary Processor 
1/0 mapped, 4K EPROM, 
4K RAM, prototype area 


$45.00 


Each 


Call or write for brochure. 
Terms: Check or money order only. CA 


residents add sales tax. Prices include 
UPS shipping. 


Applied Innovations 
3000 Scott Bivd. Suite 106 
Santa Clara, CA 95054 
(408) 748-1875 
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TECH 
REPORT 
Turbo Watch sci 


Turbo Tech Report 
peaks Your Language. 


IN THIS ISSUE: 


The newsletter/disk publication for Turbo Pascal® users 


Are you a devoted Turbo Pascal programmer, 
tired of reading about other languages? Are you 
looking for powerful utilities written in Turbo 
Pascal that you can use to develop software or 
incorporate into your programs? Are you 
interested in improving and expanding your 
Turbo Pascal programming skills? 

Then you deserve a subscription to Turbo Tech 
Report. the bimonthly newsletter/disk publication 
from the publishers of Dr. Dobb's Journal and 
Micro/Systems Journal. Each issue delivers more 
than 250K of Turbo Pascal source code programs 
on disk, and 20+ pages of articles, Turbo Pascal 
software and book reviews, and analysis and 
commentary. It’s the only publication delivering 
such focused technical articles with code on 
disk—and it doesn’t waste your time with 
information about other programming 
languages. Each valuable issue contains: 

¢ Articles on topics like speedy 3D graphics, 
mathematical expression parsers, creating global 
gotos, memory resident and AI applications and 
more—all written by Turbo experts. 

¢ Reviews of the latest Turbo Pascal software 
programs from companies like Borland 


International, Blaise Computing, Media 
Cybernetics, Nostradamus, TurboPower Software, 
and more! 

¢ News and commentary detailing the 
latest products and developments in the Turbo 
Pascal programming community. 

° A disk filled with Turbo Pascal code! 
You'll get the Turbo Pascal utilities and routines 
discussed in the newsletter’s articles, as well as 
applications developed by Turbo users from 
around the world. You'll receive programs that 
make labels, generate menus, provide faster 
screen access, transfer files between CP/M and 
MS-DOS computers, and more! 

If you're an expert Turbo Pascal programmer 
or a novice interested in expanding your Turbo 
skills, you need a publication that speaks your 
language: Turbo Tech Report. Subscribe today at 
the special price of just $99—that’s 33% off the 
regular price of $150. To order by credit card, 
call toll-free 1-800-528-6050 ext. 4001 and ask 
for item 300. Or mail the attached coupon with 
your payment to Turbo Tech Report, 501 
Galveston Drive, Redwood City, CA 94063. 


Turbo Pascal is a trademark of Borland Internationa! Inc. 


Experimenting with 
Protected Mode 
on the AT 


by Marshall Brain 


For most users, the IBM AT and its com- 
patibles, are nothing more than acceler- 
ated PCs. The AT has the same 640K 
memory limit as the PC and runs DOS pro- 
grams in exactly the same way the PC 
does, but it does its work three or four 
times faster than the older system. 

The AT’s CPU chip, the 80286, can ac- 
tually do a great deal more than simply 
emulate the 8088 used in the PC, because 
the 80286 has two separate modes of oper- 
ation. It has a Real mode, in which the 
80286 behaves just like an 8088 or 8086. 
This mode allows the AT to act like a fast 
PC. The 80286 also has a Protected mode, 
in which the chip behaves like a main- 
frame CPU. DOS currently runs only in the 
Real mode, so the extra capabilities of the 
80286 are never seen by the normal user. 

This article discusses the differences be- 
tween the Real mode and the Protected 
mode. It explains the requirements of Pro- 
tected mode operation, and uses a simple 
Turbo Pascal program to demonstrate 
taking the AT into Protected mode and 
back out to Real mode. This article as- 
sumes that you have some knowledge of 
assembly-language programming tech- 
niques on the 8088. You may also wish to 
consult the books and articles listed in the 
bibliography for additional information on 
the AT BIOS calls used and for more in- 
formation about the Protected mode. 


DIFFERENCES BETWEEN THE PC AND 
THE AT 

The AT system board has three features 
that distinguish it from the PC system 
board. First, the AT system board has not 
only the main CPU chip, but also a second 
complete microprocessor called the 8042. 
This microprocessor is used primarily as a 
keyboard interface, but it has other ca- 
pabilities that are important to use of the 
Protected mode on the AT. Second, the AT 
has a CMOS clock/RAM chip built onto 
the system board. This chip provides a 
software equivalent for the DIP switches 
found on the PC system board, but it also 
has memory locations that are needed 
when you work in Protected mode. Fi- 
nally, the AT system board contains an 
80286 processor instead of the PC’s 8088. 
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The presence of the 80286 gives the AT 
its speed boost in three ways: the 80286 
runs at a higher clock rate; the 80286 has a 
16-bit data bus, compared to the 8088’s 8- 
bit bus; and the 80286 has internal pipelin- 
ing that speeds up instruction execution. 
When running in Real mode, the AT uses 
all of these advantages to provide notice- 
ably better performance than the PC. 

The very fact of the 80286’s existence 
also gives the AT Protected mode capabili- 
ties. Once the 80286 is switched to Pro- 
tected mode, the programmer is able to 
access the following features: (1) a 16Mb 
address space, as opposed to the Real 
mode’s 1Mb space; (2) virtual memory 
support; (3) hardware multitasking sup- 
port for context switching and task separa- 
tion; and (4) an impermeable protection 
mechanism that isolates different tasks 
from one another. The AT has all of the 
essential features of a mainframe or super- 
minicomputer built in, due to the presence 
of the 80286. 


SEGMENT REGISTERS 
The main difference between the Real 
mode and the Protected mode on the AT 
lies in their use of the segment registers. A 
new use for segment registers is the key to 
the capabilities of the Protected mode. On 
the 8088, and on a 80286 running in Real 
mode, the segment registers are used sim- 
ply to address a memory space greater 
than the 64K that would be allowed by the 
16-bit width of the registers and instruc- 
tion pointer. Whenever a memory access 
takes place, it is always done relative to 
one of four 16-bit segment registers; the 
value of the appropriate segment register 
is multiplied by 16 and added to the 16-bit 
offset value. This allows the CPU to refer- 
ence any location in a |Mb address space. 
In the Protected mode, you are able to 
access up to 16Mb of physical memory 
(and up to several billion bytes of virtual 
memory), because the segment registers 
are used in a new way. Instead of being 
used as a physical memory pointer, the seg- 
ment registers are used as 13-bit pointers 
that point into tables of “descriptors.” De- 
scriptors are 8-byte (64-bit)-long values 
that are used to describe a segment. Such a 


description includes the segment’s location 
in physical memory, the segment’s length, 
and the segment’s access rights. 

Many different types of descriptors are 
possible, because many different types of 
segments are defined in Protected mode. 
There are code segments, data segments, 
and task-state segments. In general, 
though, there are two main types of seg- 
ments (and therefore segment descrip- 
tors): memory descriptors and control de- 
scriptors. This article concentrates on 
memory descriptors. Control descriptors 
are used to implement protection and 
multitasking features of the 80286, and 
will be largely ignored in this article. 

To access descriptors, you use 16-bit 
segment register values to point into de- 
scriptor tables. These tables can be 
thought of as arrays of descriptors, with 
each descriptor being an 8-byte-long ele- 
ment of the array. There are three diffent 
types of tables defined. The Global De- 
scriptor Table (GDT) is potentially acces- 
sible by any task in the system (although 
access may be denied). A Local Descriptor 
Table (LDT) can be defined for each task 
and is private to the task. An Interrupt 
Descriptor Table (IDT) is also defined and 
replaces the 256 vector pointers found in 
the first 1000 bytes on the 8088. These 
tables are stored in memory and are actu- 
ally another type of segment themselves. 

This article concentrates on memory de- 
scriptors in the GDT. Just remember that, 
in Protected mode, any segment register 
can be used to point into a descriptor table 
so that a segment descriptor can be re- 
trieved. The information contained in the 
segment descriptor is used to access 
memory. 


HOW DESCRIPTOR TABLES WORK 
Think about the following statements 
when they are made in Real mode or on 
the 8088: 


MOV AX,40H 
MOV DS,AX 


They seem almost insignificant. A 16- 
bit value is moved to AX, and then this 16- 
bit value is moved to the data segment reg- 
ister DS. These statements allow you to 
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access data beginning at memory location 
400H. 

In Protected mode, this instruction pair 
works differently. AX gets loaded as usual, 
but the loading of DS sets in motion the 
following chain of events: 


1) The upper 13-bits of the segment regis- 
ter are used as an index into the appro- 
priate descriptor table. 

2) The 8-byte descriptor is retrieved and 
placed into a descriptor cache for the 
appropriate segment register. On the 
80286, all four segment registers have 
the same 16-bit segment register found 
on the 8088, but there is also a hidden 
8-byte register that holds the current 
segment descriptor for that segment 
register. 

3) The cached information is then used 
anytime a reference is made to the 
given segment. 


This chain of events, shown in Figure 1, 
(turn to page 50 for article Figures and 
Code) occurs whenever any segment regis- 
ter is loaded with a new 16-bit value. 
Many instructions load segment registers, 
including MOV (as shown), POP, LDS, far 
CALLs and JMPs. 


Figure 2 describes the format of in- 
formation contained in segment registers 
and descriptors in Protected mode. As can 
be seen, it is the descriptor that actually 
contains the physical memory address for 
the segment. The descriptor also contains 
the length of the segment and access 
rights. When you try to access information 
using a given segment, all of this cached 
information comes into play. For example, 
assume that the following instruction is 
executed: 


MOV AX,DS[69H] 


The following events take place: 


1) The 80286 makes sure that 69H is 
within the length of the segment. If the 
segment is only ten bytes long, a pro- 
cessor fault will occur. 

2) The 80286 adds the 24-bit physical 
memory address found in the cache to 
the offset value 69H. 

3) The memory location addressed by this 
sum is loaded into AX. 


All of this takes place in hardware, us- 
ing information that has already been 
loaded, so there is no time penalty for the 
extra work done in Protected mode. The 
only speed penalty occurs when a segment 
register is loaded. At that point, the 8-byte 
descriptor value must be retrieved and 
moved from the appropriate table in mem- 
ory into the cache register. 

Descriptors give the Protected mode its 
flexibility. For example, assume that DS is 
loaded with 40H at one point. At this time, 
the descriptor may indicate that this seg- 
ment is located at memory location 
1000H. At a later time, however, 40H 
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might be moved into DS again, and this 
time the retrieved descriptor might indi- 
cate a physical address of 74500H. The 
program has no idea that the segment has 
been moved, because it used 40H to refer- 
ence the data in both cases. It is also im- 
portant to note that each segment is 
treated as a specific, fixed-length entity, 
which can be moved, or altered. This is 
somewhat different from the way seg- 
ments are treated on the 8088. 


GETTING INTO PROTECTED MODE 


To take advantage of the capabilities of 


Protected mode, the 80286 has to be run- 
ning in Protected mode. Fortunately, this is 
fairly easy, because the AT BIOS contains a 
call that will switch the 80286 into Pro- 
tected mode. Before this call can be used, 
however, some preparation is required. 

For the 80286 to work in Protected 
mode, it must have a GDT. The GDT is 
needed because the first thing that the 
80286 does when it gets to Protected mode 
is to try to get the descriptor for the CS 
register. Without this it cannot execute any 
instructions. Also, the first instructions exe- 
cuted once in Protected mode are instruc- 
tions that load the SS, DS, and ES registers, 
so that the program can access data and 
make subroutine calls. These four descrip- 
tors will be found in the GDT, so the GDT 
must be set up in Real mode before the 
switch to Protected mode is made. Once 
these four descriptors are cached, the 


80286 can work on its own in Protected 
mode by creating or modifying descriptor 
tables to give it access to any memory loca- 
tion. The Protected mode needs the Real 
mode, though, to get things started. 

To switch to Protected mode, an AT 
BIOS routine can be used. This routine is 
accessed using interrupt 15H, function 
89H. As shown in the AT Technical Ref- 
erence Manual, this routine requires that 
a GDT be set up before it is called. It also 
requires that an IDT be created. Normally, 
the IDT is set to handle at least the 14 pro- 
cessor faults possible on the 80286. These 
processor faults are shown in Figure 3. A 
problem arises with these faults, however, 
because the original PC architecture de- 
fined hardware and software interrupts at 
many of these locations. The BIOS routine 
therefore allows the programmer to remap 
the hardware-interrupt controllers so that 
their vectors don’t occur within the first 14 
interrupts. 

This is all that is required to go to Pro- 
tected mode. It would be nice, however, to 
be able to get back to Real mode eventu- 
ally through software, rather than having 
to turn the machine off and back on to get 
back to DOS. Unfortunately, the 80286 
has no provision for getting back to Real 
mode from Protected mode. Apparently 
the designers assumed that the Real mode 
would be used once to initialize a GDT and 
IDT, and that there would be no reason to 
return. 
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To get around this problem, a sort of 
Rube Goldberg machine was built into the 
AT that allows it to return to Real mode. It 
is used by the VDISK utility, for example, 
to allow it to access expanded memory. 
VDISK switches to Protected mode so that 
it can access the full 16M address space, 
stores or recalls information above the 1M 
memory limit of Real mode, and then re- 
turns to Real mode. To take advantage of 
this mechanism, you must set it up before 
entering Protected mode. 

The mechanism works like this: To get 
back to Real mode from Protected mode, 
the 80286 sends a message to the 8042 mi- 
croprocessor on the AT system board. This 
message says, “Reset the machine.” The 
8042 does this, sending a hardware reset 
across the AT system board. This is essen- 
tially the same signal as the signal created 
by powering off and back on. The 80286 
resets, and the BIOS starts executing its 
normal power-on sequence in Real mode. 
(Whenever the 80286 is reset, it comes up 
in Real mode.) Just before it starts its 
power-on self-test routines, however, it 
looks into the CMOS RAM. If it finds one 
of several different values in location OFH 
of that RAM (the CMOS RAM has its own 
address space), it knows that the reset sig- 
nal was not a “power on” signal, but in- 
stead a “returning from Protected mode” 
signal. The value 05H in location OFH 
tells the BIOS to do a far jump directly to 
whatever location it finds in memory at 
467H and 469H. 

To use this mechanism, the programmer 
is required to set the CMOS RAM so that 
an OSH appears in its location OFH and 
must also set up 467H and 469H (loca- 
tions in the BIOS reserved memory area) 
to contain the address of the code that 
should begin executing when the computer 
returns to Real mode. If this is done cor- 
rectly, the 80286 can go to Protected mode 
and then back to Real mode without any 
problems. 


AN EXAMPLE PROGRAM 

Keeping all of this in mind, examine the 
example program. The main routine spells 
out the steps necessary to get into Pro- 
tected mode. 

The first statement sets up the GDT. 
The BIOS call being used requires eight 
descriptors, as described in Figure 4. This 
routine simply sets the physical memory 
address, segment size, and appropriate 
access-rights byte into each descriptor. For 
most, the value 92H in the access-rights 
byte indicates that the segment is present, 
has a privilege level of 0 (used for the pro- 
tection features—0 is the highest level), is 
not executable, and is both readable and 
writeable. For the code segment, the 
access-rights byte indicates that the seg- 
ment is present, has a privilege level of 0, is 
executable (the 80286 will not allow data 
segments to be executed, or code segments 
to be written into), and is readable (you 
can make code segments nonreadable to 
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keep other routines from stealing the 
code). For more information, refer to the 
Intel manual in the bibliography. 

The next step is to set up the IDT for the 
14 processor fault vectors. The descriptors 
here are used as “call gates” (a type of 
control descriptor). For example, the 
statement ““SET_IDT_DESC(0, ... ” sets 
up the IDT descriptor 0 (also vector 0 and 
fault 0), so that an interrupt 0 goes to the 
routine FAULT in the code segment. The 
“+7” makes sure that the code put in 
place by Turbo Pascal to allow local vari- 
able access is ignored. Don’t try to access 
local variables from the fault routine (once 
FAULT calls something else, the called 
routine can access local variables). All 
fault routines point to the same fault han- 
dler that beeps the speaker twice. 

The next step saves the segment regis- 
ters needed to run in Real mode (SS, DS, 
and ES). When you return to Real mode, 
these values are reloaded into the appro- 
priate segment registers. Once this is done, 
Turbo never knows that it was out of Real 
mode. These values are stored in typed 
constants, which reside in the code seg- 
ment. The values can be accessed, since 
DS and SS are unknown. 

When the BIOS call for Protected mode 
executes, it remaps the hardware inter- 
rupts to whatever location is requested. It 
also masks off all hardware interrupts so 
that they can’t get in to bother the 80286 
while it is in Protected mode. When re- 
turning to Real mode, the interrupts are 
remapped to their normal positions, but 
they remain masked off. To allow them to 
work again, you must set the masks in the 
interrupt-controller chips back to their 
original states. The SAVE_8259_REGS 
routine saves the contents of the mask reg- 
isters so that they can be correctly restored 
upon return to Real mode. 


The next routine sets 05H into location 
OFH of the CMOS RAM. It sends address 
OFH to port 70H (the CMOS RAM address 
port, which gives this RAM its own address 
space), and then writes the value 05H into 
port 71H. This causes the CMOS RAM 
chip to move the 05H into location OFH. 

Next, locations 467H and 469H are set 
to the address of the exit-point routine that 
will be used when the return to Real mode 
occurs. Again, the “+7” is used to cir- 
cumvent the local-variable-address setup 
code. The exit-point routine cannot access 
local variables. 

Finally, the 80286 can be taken to Pro- 
tected mode. A small piece of inline code is 
used to set the registers to their appropri- 
ate values and call the interrupt. You can- 
not use the INTR procedure here because 
the BIOS call destroys BP, and INTR tries 
to use it. 

Once you enter Protected mode, all of 
its capabilities are opened to you—the 
16M address space is available, as well as 
virtual memory support, protection, etc. 
So why then, after all of this work, does 
the program simply beep once and drop 


back to Real mode? This occurs for sev- 
eral reasons. First, the hardware inter- 
rupts are off, so the keyboard does not 
work. The screen cannot be accessed be- 
cause the video BIOS call is not entered in 
the IDT, and a descriptor for the video 
memory space does not exist. The disk 
drives don’t work for a variety of reasons. 
Essentially, the AT becomes a naked ma- 
chine, and the speaker is the only accessi- 
ble output device. While in Protected 
mode, you can do most non-I/O and things 
unrelated to the heap that you normally do 
in Turbo Pascal, although the results of 
any calculations must be sent out in beeps. 

To get out of Protected mode, the 8042 
is told to create a hardware reset by send- 
ing OFEH to port 64H. The HLT com- 
mand halts the processor until the reset 
can take effect. The Rube Goldberg ma- 
chine then takes over and eventually be- 
gins executing the program again at the 
exit-point routine. This routine restores all 
segment registers, replaces the mask regis- 
ters, and returns. If you make a drawing of 
the stack contents through all of this, you 
will find that what is on the stack at the 
time of the exit point’s return is the ad- 
dress of the caller of GOTO_ PRO- 
TECTED_ MODE. The exit-point routine 
returns to the main routine, which returns 
to DOS. 

There are several things you should 
bear in mind while Turbo Pascal is run- 
ning in Protected mode. First, no screen, 
keyboard, or disk I/O is possible for the 
reasons mentioned above. In addition, no 
BIOS or DOS function calls are available. 
You cannot access the heap, because the 
heap manager loads many segment values 
that have no entries in the GDT. The com- 
piler directives shown must be off, or the 
program will not work. Typed constants 
(whose values are stored in the code seg- 
ment) cannot be written to while in Pro- 
tected mode, because the 80286 guards 
against any modification of executable 
code segments. Finally, local variables or 
parameters should not be used in the 
routines mentioned above, because the BP 
register is either lost or destroyed. Any 
routines called by these routines, however, 
can have local variables and parameters. 


EXPERIMENTING 

Once you have the Protected mode pro- 
gram working—that is, it runs, beeps 
once, and returns to the Turbo Pascal envi- 
ronment—you can try several easy modifi- 
cations and experiments. One of the first 
might be to create processor faults while in 
Protected mode. 

You can create processor faults in sev- 
eral ways, but the easiest involves the cre- 
ation of a nonpresent segment. For exam- 
ple, the access-rights byte for the Data 
descriptor in the GDT (descriptor number 
3 in Figure 4 and in the SETUP_GDT pro- 
cedure) has an access-rights byte of 92H, 
or 10010010. Figure 2 shows that bit 7 is 
used as a “present” bit; you can mark a 
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segment “not present” by changing bit 7 
to zero. This is normally done in a virtual 
memory system. When a segment is 
swapped out to disk, the descriptor is 
marked “not present.” The next time that 
segment is referenced, a not present fault 
(fault 11) occurs, which allows the operat- 
ing system to pull that segment back into 
physical memory, set the descriptor to in- 
dicate “present,” and then restart the 
faulting instruction. 

To try this, simply change the access- 
rights byte of descriptor number 3 in the 
GDT from 92H to 12H. Now, when the 
program executes, it will try to load the 
descriptor for DS, and a not present fault 
will occur. You will hear two beeps instead 
of one to indicate that the fault took place. 

You can also do this with the extra and 
stack segments. The stack segment will 
use fault 12 instead of 11, although you 
won’t hear any difference. Do not try this 
on the code segment, however. If you 
change the code-segment descriptor to 
1AH, the program will crash. This occurs 
because the 80286 never gets a code- 
segment descriptor loaded and can there- 
fore do nothing. 

When experimenting with faults, or 
when debugging, it is nice to know exactly 
which fault is occurring. You may wish to 
create 14 different fault routines—one for 
each possible fault. Fault 0 might beep 
once, fault 1 twice, etc., so that you know 
exactly which fault occurred. Create the 
14 routines, and then change the descrip- 
tors in SETUP_IDT so that each one points 
to the appropriate fault routine instead of 
to the generic fault routine. Then recom- 
pile the program. (A note on compiling: 
All tests for this article were performed 
using an IBM AT and Turbo Pascal Ver- 
sion 3.00B. It is unknown how the pro- 
gram will behave on AT compatibles or on 
older versions of Turbo Pascal.) 

It would be nice to have some output 
device other than the speaker. You may 
have noticed that an extra descriptor is in- 
cluded in SETUP_GDT. The 
TEST_SCREEN routine can use this de- 
scriptor to access the screen as an output 
device from Protected mode. To make use 
of this routine, first remove the comment 
braces from around the TEST_SCREEN 
call. Then modify the physical address for 
descriptor 8 in the GDT to match your sys- 
tem. If your system uses an EGA or CGA 
board, the call to ADDR24 should use the 
value $B800 for the physical address. If 
you use a monochrome adapter, the ad- 
dress should be $B000. 

Once you have made these changes, 
compile the program and run it. It should 
print “HELLO FROM PROTECTED 
MODE” onto your screen several times. 
This routine takes full advantage of the 
redirectability of segments to access the 
screen. An absolute array SCREEN is de- 
clared at the beginning of the program. It 
has been declared to point. to $40:0. If you 
decode 40H in light of the Protected mode 
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use of segment values, you will find that 
this corresponds to descriptor 8. Descrip- 
tor 8 has been directed (in the GDT) to 
point at the physical memory address that 
contains the screen memory buffer. The 
routine DISPLAY simply writes informa- 
tion into the appropriate address in the 
screen buffer by accessing the segment 
value $40. The absolute address feature of 
Turbo is convenient in this case. Whenever 
the screen array is accessed, the segment 
value $40 is loaded into a segment register. 
This retrieves the descriptor needed to ac- 
cess the screen. 


You can use the DISPLAY routine to 


create a CLRSCR procedure for Protected 
mode. Simply display 25 lines of spaces on 
the screen. 


CONCLUSION 

This article has shown how to get Turbo 
Pascal to run, with limitations, in Pro- 
tected mode, but it has barely scratched 
the surface of the Protected mode’s ca- 
pabilities. You will find that you can use 
Turbo Pascal to create a comfortable envi- 
ronment for further experimentation with 
Protected mode features. § 
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Software Review 


COMP Computing 
Standard MUMPS 


by Michael Guttman and Robert Engle 


A Microcomputer 
Version of the 
MUMPS language, 
Intended For 
Whiting Database 
Applications 


MUMPS is a little-known but well- 
established database application develop- 
ment environment, developed for mini- 
computers and mainframes. Its unusual 
moniker is an acronym for Massachusetts 
General Hospital Utility Multi-Program- 
ming System, a hint of its rather obscure 
origins. MUMPS has largely outgrown its 
original pedigree, however, and is now in 
use around the world on many different 
machines and for many different 
applications. 

Recently, various PC versions of 
MUMPS have begun to make their appear- 
ance, including the one reviewed here. This 
is obviously of interest to the rather small 
community of programmers already using 
MUMPS on larger machines, but why 
should the rest of us get excited? Ordinary 
PC users may be surprised to discover that 
for the paltry price of Turbo Pascal 
($59.95), they can now purchase a full im- 
plementation of a powerful mainframe da- 
tabase package that, in many ways, runs 
circles around the far more expensive best- 
sellers of the database genre. 

To find out just what MUMPS has to of- 
fer, we looked at CCSM (COMP Comput- 
ing Standard MUMPS), a new version of 
MUMPS for the IBM PC from Guidance 
Software, Inc., of Kingwood, Texas, and 
exclusively marketed by MGlobal of Hous- 
ton, Texas. Before we delve into the par- 
ticulars of CCSM, we offer a general dis- 
cussion of MUMPS. 

MUMPS was developed in the late 
1960s by a group of programmers at 
Massachusetts General who were frus- 
trated by the time and overhead required 
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to prototype and complete database-ori- 
ented applications using then-available 
programming languages such as COBOL 
and FORTRAN. Like the great PC innova- 
tors of today, they decided to throw out 
the rule book and develop, largely from 
scratch, an applications development envi- 
ronment based strictly on their own 
requirements. 

The result of their efforts must have ap- 
peared astounding in its day. MUMPS 
emerged as a full language in its own right, 
directly supporting all the usual operations 
for logic control and I/O. Moreover, the 
new language was completely interpretive 
(still a novelty then), so its users could say 
goodbye to the cumbersome array of main- 
frame compilers, linkers, debuggers, and 
dump translators, thereby speeding devel- 
opment time by at least an order of 
magnitude. 

The most important and novel advan- 
tages of the new language, however, were 
in the areas of data manipulation and data- 
base architecture. The new language of- 
fered support for arrays of any dimension 
and flexible typing of variables. It also pro- 
vided a fast, convenient, and powerful 
scheme for maintaining indexed data files, 
including support of variable-length 
records, fields, and keys, and a full- 
featured file- and record-locking scheme 
for multiuser operation. 

Not surprisingly, the language was an al- 
most-instant hit in hospital DP shops and 
was soon ported to new environments and 
picked up by a number of big clients. One 
of those clients was the U.S. government, 
which, through the VA and other agencies, 
runs a lot of hospitals. Attempts were made 
to standardize application development 
around MUMBPS, and a canonical version of 
the MUMPS language was submitted and 
accepted as an ANSI standard—a distinc- 
tion applied to very few languages. 

Ironically, however, this Cinderella rise 
from obscurity to acceptance may actually 
have worked to hide MUMPS from the gen- 
eral public. With excellent versions already 
in the public domain, MUMPS failed to at- 
tract the attention of any major vendor and 
was thus never hawked to the commercial 
sector. As a result, it remains something of 
a cult language, as a host of proprietary 
application development products have 
garnered the bulk of commercial attention 
and dollars. 


GETTING STARTED 

Our copy of CCSM came with two disks 
and two manuals. One disk and manual 
were devoted to this version of MUMPS it- 
self, while the other disk and manual com- 
prised a “cookbook” of generic MUMPS 
routines that illustrate many of the features 
available in MUMPS. A page of installation 
notes was also provided, with which we 
tried to install the system on our 20-Mb 
Leading Edge PC clone. It quickly became 
apparent that both the documentation and 
the setup files provided were not geared to 
installing CCSM on a hard disk—a strange 
approach, given the package’s usual func- 
tion of developing database applications. 
After a little hacking around, however, we 
had no real trouble getting MUMPS to 
work properly on our hard disk. 

Once installation is complete, invoking 
the MUMPS.EXE file brings CCSM up in 
the interpretive mode, with an asterisk as a 
prompt. MUMPS commands have a simple, 
intuitive, and free-form syntax. For exam- 
ple, the command line 


* SET A = “PRINT SOMETHING” 
SET B = “USING MUMPS” WRITE A,B 


will actually execute two SET (assignment) 
statements and one write statement, even 
though no special delimiters are used. For 
the cryptic-minded, this statement can be 
further simplified to: 


* S A="PRINT SOMETHING”, 
B=” USING MUMPS” W A,B 


In either case, the result would be 
simply: 


PRINT SOMETHING USING MUMPS 


MUMPS also supports macro substitu- 
tion with the @ prefix, as in: 


* S C="A,B” W @C 


which would also achieve the same result as 
W A,B. 


PROGRAMMING 

Fooling around in the immediate mode was 
certainly fun, but the acid test of CCSM 
comes in developing real programs. Pro- 
grams are created with a supplied editor 
and then executed using the DO 
command—a process oddly similar to one 
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in dBASE III. Unfortunately, the editor 
that comes with CCSM is rather slow and 
clunky, and its use was essentially manda- 
tory, since all MUMPS programs (and 
data) are stored on disk in a special 
MUMPS format that is basically unread- 
able by other programs. There is a way to 
read standard ASCII files, but the docu- 
mentation was not clear as to how this 
could be used to support the use of a exter- 
nal ASCII editor. Because the programs we 
wrote were short, we put up with the CCSM 
editor, but serious MUMPS programmers 
will need to construct some sort of 
alternative. 

Each line of a MUMPS program consists 
of an optional label and a series of com- 
mands and expressions. Like most pro- 
gramming languages, MUMPS executes 
from beginning to end, altering the flow in 
response to GOTO or DO commands, which 
may refer to internal or external routines. 
Even though MUMPS is completely inter- 
pretive, a reference to an external routine 
doesn’t appear to require any more over- 
head than to an internal one, and it exe- 
cutes at the same speed. 

In addition to DO, GOTO, SET, and 
WRITE, a complete set of programming 
commands and operators are provided. 
These include the commands READ for 
keyboard input; OPEN, CLOSE, and USE 
to control the current 1/O device; QUIT and 
HALT to exit from routines or MUMPS; IF, 
ELSE, and FOR for loop control, and KILL, 
which gets rid of unwanted variables and 
arrays. There are many string, numeric, 
and screen functions and, for multiuser op- 
eration, commands for starting and abort- 
ing jobs and locking and releasing 
variables. 


STORING DATA 

In the example given above, the variables 
A, B, and C are simple transient scalars 
that will disappear after MUMPS exits. 
However, MUMPS also allows the creation 
of what are called global variables, which 
are always stored on disk and can be re- 
trieved at any time. Also, both local and 
global variables can be multidimensional 
arrays. As in Snobol, array subscripts can 
be anything at all. For example, the 
expression 

* S A(”JONES”,”RALPH”) =” 
PROGRAMMER” 

will actually create a variable called 
A("JONES’,”RALPH”) and give it the 
value "PROGRAMMER’. In reality, 
MUMPS handily stores the data "PRO- 
GRAMMER’” away in a B-Tree index un- 
der the keys "JONES” and “RALPH”, 
which makes it possible for you to retrieve 
the data directly with these parameters. 
There are few restrictions on how this 
subscripting can be done. No dimensions 
need be declared in advance, and all as- 
signments can be made “‘on the fly.” Com- 
pared to conventional programming lan- 
guages and databases, the power of this 
approach is enormous. You can.concoct all 
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sorts of schemes for organizing data and 
add new elements and dimensions at any 
time without having to perform costly and 
cumbersome conversions. The strings have 
a length limit of 255 characters, however, 
and there are some limitations on the 
number of characters allowed in the vari- 
ous subscripts of a single entry. Even so, it 
is easy to create simple applications re- 
quiring indexed data and not much harder 
to create and maintain other inverted lists 
for secondary keys. 


A PROGRAMMING EXAMPLE 

The program in Listing | is a good exam- 
ple of how flexible and compact MUMPS 
code can be. This routine is a simple, gen- 
eralized, data-entry program. By using the 
macro substitution (@) feature described 
earlier, this program will provide the basic 
control logic to accept any sequence of 
data-entry fields. Listing 1A is taken from 
the CCSM cookbook manual, with minor 
changes. In Listing 1B, we have taken the 
liberty of expanding the abbreviated com- 
mands to make the listing more readable 
to those new to MUMPS. A full text ex- 
planation follows. (See listings on page 
40.) 

This program assumes that a global ar- 
ray called LIST has already been created 
that describes a data-entry system (similar 
to a format file in dBASE, for instance). 
Each element in LIST contains four pa- 
rameters: a prompt name, a logical test in 
MUMPS code, a reference pointer telling 


where the entered data is to be placed 
(presumably, in some global variable), 
and an error message should the logical 
test fail. As programmed here, these pa- 
rameters are assumed to be separated by 
commas, in the general form: 


PROMPT, TEST, REFERENCE, 
ERRORMESSAGE 


The first line of the BEGIN routine sets 
up a loop (FOR I=1:1} that terminates if 
the value of the data in LIST(I) is zero or 
null (QUIT: DATAS(*LIST(I))}. The ” sign 
here means ’not’, and the * sign means 
that LIST is a global, not a local, variable. 

Assuming that LIST(I) exists, a local 
variable XX is then set to it {SET 
XX=“*(I)}, where * refers to the last global 
used. Then the GETDATA routine is called 
{DO GETDATA}, and the loop iterates. 
When the loop finally ends, all the local 
variables are killed {KILL 
I,X,XX,PROMPT,TEST,REF}, and the rou- 
tine is QUIT. The first line of the 
GETDATA routine parses the PROMPT, 
TEST, and REF parameters from the local 
variable XX, using the MUMPS parsing 
function P$. The second line prints the 
prompt, then any existing data, and some 
slashes {WRITE:$SDATA(@REF) @REF). 
Then the routine requests input from the 
keyboard {READ X QUIT:X=””}, storing 
it in X and quitting if X is null. 

The third line of GETDATA performs 
the test stored in TEST {IF @TEST}, then 
writes a linefeed {WRITE }}, sets the refer- 
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ence to X {SET @REF=X}, and quits. The | PRODUCT INFORMATION 
final line is only executed if the test fails; a 
bell is rung using ASCII 7 {WRITE *7,” "}, | CCSM—$59.95 


followed by the parsed-out error message. 
Then the GETDATA routine is called 
again. 


OTHER FEATURES AND EXTENSIONS 
Unfortunately, much of the documenta- 
tion provided for MUMPS commands and 
operators is cryptic and disorganized. 
Moreover, some of the information pro- 
vided in the manuals is incomplete, incor- 
rect, and contradictory, making the ex- 
perience of learning the finer points of 
MUMPS frustrating for a new user. For 
example, several listings from the manual 
had blatant mistakes, and many forms of 
the functions used in examples were diffi- 
cult to find in either manual. 

Users who are willing to do some dig- 
ging will find some interesting and valu- 
able features offered with this version of 
MUMBPS, though. For example, it is possi- 
ble to read and write ordinary PC-DOS 
files, to make use of an 8087 chip, to trans- 
fer files to and from other MUMPS sys- 
tems, to customize CCSM for various for- 
eign codes and formats, to list and cross- 
reference routines and variables, to 
manipulate CCSM error-trapping and 
error-message routines, to back-up and 
copy global variables, to journalize events 
such as global creation and destruction, to 
modify screen attributes, and so on. 

Our version of CCSM was single user, so 
we weren’t able to test multiuser func- 
tions. According to the literature, how- 
ever, it is theoretically possible to run up to 
15 users on a properly configured PC/XT 
or PC/AT, and it is possible to network up 
to 255 multiuser nodes. We also did not 
test an optional PC graphics package that 
allows users to draw in a variety of shapes, 
colors and textures. Support is provided 
for the IBM Color Graphics Adapter and 
for a number of more advanced graphics 
boards and monitors. 


CONCLUSION 

On the whole, we are very happy with” 
MUMBS, and CCSM appears to be a fairly 
good and efficient implementation of the 
ANSI standard, along with many useful 
extensions. We must reiterate, however, 
that the documentation is confusing and 
rather inconvenient to use. This should not 
be any great burden to seasoned MUMPS 
users, but it is a major annoyance to begin- 
ners. If MUMPS is to gain converts from 
other, more popular, microcomputer lan- 
guages and databases, more attention to 
the details of documentation is definitely 
required. § 


Michael Guttman and Robert Engle are 
independent computer consultants based 
in Cherry Hill, NJ. 
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CCSM + Cookbook—$75.90 
Graphics Disk—$49.95 


MGlobal 

1601 Westheimer, Ste. 201 
Houston, TX 77006 

(800) 257-8052 

(713) 529-2576 (in Texas) 


Typical MUMPS Listing (1A) 
1 Q:'DS(*LIST(I)) S XX=*(I) D GETDATA 
XX, PROMPT, TEST, REF 


GETDATA S PROMPT=SP (XX,"/",1), TEST=$P (XX,"/",2), 
REF=P$ (XX, "/",3) 


W PROMPT,": “ W:SD(@REF) @REF," // " R X Q:X="" 
I @TEST W! S @REF=X Q 
W*7,"  ",SP(XX,"/",4),! G GETDATA 


Expanded MUMPS Listing (1B) 


BEGIN FOR I=1:1 QUIT:'DS(*LIST(I)) SET XX=*(I) DO GETDATA 
KILL I,X,XX, PROMPT, TEST, REF 
QUIT 


GETDATA SET PROMPT=SP (XX,"/",1), TEST=$P (XX,"/",2), 
REF=P$ (XX, "/",3) 
WRITE PROMPT,": " WRITE:$D(@REF) @REF," // "™ 
READ X QUIT:X="" 
IF @TEST WRITE ! SET @REF=X QUIT 
WRITE *7,"  ",$P(XX,"/",4),! GOTO GETDATA 


ET @REF=X QUIT 


WRITE *7," ",S$P(XX,"/",4),! GOTO GETDATA 


AFFORDABLE 
ENGINEERING 
crm SOFTWARE ,...; 


MSDOS PCDOS 


AND APPLICATIONS GUIDE 


ACNAP — 


POP — Plotter Driver Program 
os AC Network Analysis $72.95 


woeponpotes 97299 


XFER — Transfer Function Synthesis 


Bocca = 97299 


Users’ 
Group 


cee © 17295 


SPP — 
Signal Processing Program 872.95 


Over 90 volumes of public TEKCALC — Scientitic Calculator | ORO Scon pining $72.95 
PET etd . . Program 
domain ‘‘C"’ software including: Scteen graphics/ pcetor — 


High Resolution Grachies $72.95 


Pegormae «= 972.95 


© compilers iii ; 
e editors COMCALC — Communications Root Locus Analysis 72.95 
© text formatters Design Spreadsheet noe 

© communications Croat = 97295 | rctneriterceson $72.95 
sane oa Analysis 572.95 


RIGHTWRITER — Report 
Proofreader Program 


Zmouecsteen 997.95 


e many UNIX-like tools 


MATRIC MAGIC — 
Matrix Manipulation 


572.95 


Write or call for more details 


The C Users’ Group — 
Post Office Box 97 BY Engineering Fen |@@| 
McPherson, KS 67460 Professional Software (714) 781-0252 


(316) 241-1065 2200 Business Way. Suite 207, Riverside, CA 92501 USA 
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Hard Disks 


IBM AT Compatible 
Features: 


* 
— 512K RAM expands to 1MB 


33% faster than IBM AT 


Let PC INNOVATIONS provide, install, 
and test the proper Hard Drive for yourAT 


1.2MB floppy drive MADE IN 


8/6 MHZ CPU 80286-8 eriveonly) 
— USA BIOS fully compatible U.S.A. SEAGATE 225 65MS $310 
— Clock/calendar w/battery SEAGATE 4026 39MS $549 
— Hard disk floppy controller SEAGATE 4038 39MS $595 
AT style Keyboard SEAGATE 4051 39MS $699 
s thee SEAGATE 4096 28MS $1095 


— 195 watt power supply 

— 48 hour burn in 

— Full documentation 
Includes setup software 

— One year limited warranty 


MINISCRIBE 70MB 28MS $1195 


10MHz Zero Wait Stat 
SI Rating 11.7 ow $1495 


EVEREX EGA NEC MULTISYNC | EVEREX TAPE BACKUP 
GRAPHIC CARD SYSTEMS The best tape backup 
" money can buy 
INTERNAL EXTERNAL 
20MB $589 $639 
— 16 colors 640 x 350 res 60MB $759 $829 
100MB -— $929 


= ceo wash $249 = Se - CGA monitor $569 
TRY PC INNOVATIONS PERIPHERAL CARDS FCC CLASS ‘B’ APPROVED 


1/0 for AT THE EDGE HERCULES AT MEMORY CARD | MULTIFUNCTION 
COMPATIBLE CARD FOR AT 


Complete subsystem w/software 


— Color display - — Up to 3MB 
*XT Version available — Hercules mono -_ opalerclgllag chan — Up to 3MB - Serial port 
— Half slot 132 column — Printer port — No piggy back — Optional 2ndserial port 
— Parallel port — Printer port — Optional serial port — Split memory — Parallel port 
— Serial port Software — Runs Lotus 123 — Uses 64K or 256K chips — Game adaptor 
— Optional 2nd serial — Lotus 123 graphiics graphics — Software — Software 


HAYES 1200B MODEM 


PC INNOVATIONS SPECIAL OFFERS 


EPSON FX 286 
EPSON FX 85 $379 
EPSON LQ 800 $549 


With SmartCom Ii 


$349 


TEAC floppy disk 360K $89 1.2MB $119 


— Toshiba floppy disk 360K$951.2MB $125 EPSON LQ 1000 $739 

cs 2400 BAUD CALL | Floppy disk controller $40 | Toshiba P321 printer $525 
EVERCOM 1200 BAUD $128 | Multifunction floppy disk controller $95 Toshiba P341 printer $757 
U.S. Robotics: XT 150 watt power supply $75 | Leading Mfg. 13” RGB display $259 


AT 192 watt power supply $109 
Memory chips, Eproms, 8087,80287 CALL 


MS400 AT 4 port serial card $115 
MS400 XT 4 port serial card $110 


2400 Internal $389 
2400 External $389 


XJ Ons 
OX PC INNOVATIONS “%. 
fe) \) 2-O<5 

Neo ESTABLISHED SINCE 1980 631 S. Main Street + Plymouth, MI 48170 Oe S 


D, 
ON so wre rae (313) 451-0664 oe 


Hercules are trademarks VISA & MasterCard Welcome 
of their respective 
companies Prices subject to change < 


Our trained sales and technical staff is ready to serve you. 
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COMPETITIVE EDGE 


631 S. Main St. — Plymouth, MI 48170 — (313) 451-0665 
Competitive Edge brings you Lomas Data Products Inc. 


S-100 CIRCUIT BOARDS 


Thunder 186, 512K, 2 Serial, 1 Parallel, Floppy Disk Controller, Clock, All on One Board with Concurrent DOS 


8MHX Lightning 286 CPU $756 NV Disk 512K, Memory Drive $369 512K Dram Megagram 
10MHZ Lightning 286 CPU 821 Concurrent DOS Single User 280 Thunder +186 512K 10MHZ 
Control It All Floppy & HD Controller 479 MSDOS™ for 86, 186, or 286 200 Thunder +186 1024K 10MHZ 
Hazitall 2 Serial, 2 Par, Clock 239 CPM22EM 8080 Emulator 55 Octaport 4 Serial 

256K Dram Megaram 358 Mega S Ram 256K Static 371 NV Disk 2048K Wow!! 

1024K (1 Megabyte) Megaram 599 8 MHZ Lightning 8086 420 Concurrent DOS Multi-user 
Mega S Ram 16K Static 262 LDP Floppy Contr. 220 LDP-COM Modem Program 
Octaport 8 Serial to 38.4K 320 Color Magic Color Graphics Board 476 PC DOS Drivers 


COMPETITIVE EDGE INTEGRATED SYSTEMS 

THUNDER 186, 4 SLOT PC STYLE CABINET, 2-5” FLOPPYS, CDOS 512K 
THUNDER 186, 4 SLOT, 20 MB HARD DISK, 1-5” FLOPPY, CDOS 512K 
THUNDER 186, 4 SLOT, 20 MB HD, 1-5” FLOPPY 4 USER 1024K 

THUNDER 186, 4 SLOT, 2-5” FLOPPY, COLOR MAGIC, KEYBOARD 512K 
8MHZ 286, 1-5" FLOPPY, 1024K, 20MB HD, 10 SERIAL, 15 SLOT, 7-8 USERS 
8MHZ 286, 1-5” FLOPPY, 1024K, 40MB HD, 10 SERIAL, 15 SLOT, 7-8 USERS 
10MHZ 286, 1-5” FLOPPY, 1024K, STATIC, 40 MB HD, 10 SERIAL, 7-8 USERS 
10MHZ 286, 1-5” FLOPPY, 512K STATIC, 40 MB HD, 2 SERIAL & 80287 

8MHZ 8086/8087, 1-5" FLOPPY, 512K DRAM, 20 MB HD, 2 SERIAL CDOS or MSDOS 
10MHZ 286 1-5” FLOPPY 1024K 120MB HD 10 SERIAL SLOT 7-8 USERS CDOS 


LOMAS STATIC RAM NEW 256K TO 1024K PRICES START AT $412 


FEATURING CompuPro® FROM VIASYN™ 


S-100 CompuPro® CIRCUIT BOARDS 

Disk 1A™ Floppy Disk Controller $449 Network 100™ Network Board $379 Interfacer 4™ 3 Serial 1 Par 

8 MHZ 286 CPU A&T 2 CYL. 80287 Option for 286 CPU 295 CPU Z™ 8MHZZ80 

Ram 22™ 256K Static Ram A&T Concurrent DOS™ 8-16™ 739 MDRIVE-H 2048K, 2MB 

Ram 23™ 64K Static Ram A&T CP/M® 2.28” or 5” 189 Keytronics 5150 for PC Video 
Interfacer 3™ 8 Serial Ports Disk 3™ Hard Disk Controller 529 Passive Hub for Network 100 
SPU Z ™ 8MHZ Z80, 256K Multiuser 369 10MHZ 8088, 85/88 CPU A&T 269 HX-12 Hi-Res Color Monitor PC 
MDRIVE-H™ 512K Memory Drive 559 Ram 23™ 128K Static Ram A&T 275 CP/M® 8-16™ 

PC Video Board for IBM® Compat 379 System Support 1™ A&T 309 SP186 512K Slave 


HARD DISK SUB-SYSTEMS 
40 MEGABYTE HARD DISK, CABINET, DISK 3, SUB-SYSTEM 
80 MEGABYTE HARD DISK, CABINET, DISK 3, SUB-SYSTEM 
ALLOY 17 MB TAPE BACKUP 
40 MEGABYTE HARD DISK, CABINET, DISK 3, 5” FLOPPY 
8" & 5" FLOPPYS, 40 MB HARD DISK SUB-SYSTEM 
SYSTEMS INTEGRATED BY COMPETITIVE EDGE 


COMPUPRO® BUILT SYSTEMS 
COMPUPRO MP14 — 14 USER (7 DUAL 186 SLAVES) 10 MHZ 286 80 MB $13995. 
COMPUPRO 286/80 1024K, 10MHZ 286, 80 MB 4-8 USERS EXPANDABLE 9249. 
COMPUPRO 286/40 768K, 8 MHZ 286, 40MB 4-5 USERS EXPANDABLE 6649. 
COMPUPRO 10+ 768K (256K ADDITIONAL SLAVE MEMORY) 40 MB 4 USERS 4436." 


Ask About Sperry Service Contracts on CompuPro® 
QUANTITY AND DEALER DISCOUNTS AVAILABLE 
ALL PRICES SUBJECT TO CHANGE — SHIPPING EXTRA — *LIMITED TIME 


IBM is a registered trademark of International Business Machines, CP/M, Concurrent DOS are registered trademarks of Digital Research Inc. MSDOS is a trademark of Microsoft. 
All above circuit board names are either registered trademarks or Trademarks of Viasys Corporation. CompuPro is a registered trademark of Viasyn Corporation. AT is a trademark 
of IBM. 


NO EXTRA CHARGE FOR VISA OR MASTER CHARGE 
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COMPETITIVE EDGE 


631 S. Main St. — Plymouth, MI 48170 — (313) 451-0665 


INTRODUCING 


VELOCITY 286-10""/12 


A T™ COMPATIBLE 


10/12 MHz 
=|) OPERATION 
<@°% 1024K on MOTHERBOARD 


16 BIT HARD DISK TRANSFERS 
SERIAL, PARALLEL, CLOCK 


Enhanced Graphic Adapter Now Standard Runs with Color or Mono Monitor 
1.2 MB Floppy, A T™ Compatible Keyboard, DOS 3.2 


30 MEGABYTE FAST HARD DISK (38MS) 
10 MHZ Velocity 286-10 As Above $2595. 
12 MHZ Velocity 286-12 As Above $2895. 
132 Column by 44 Lines No Cost Option 
10 MHZ Velocity 286-10 with 70MB 28MS H.D. $3095 
12 MHZ Velocity 286-12 with 70MB 28MS H.D. $3395. 


SHIPPING NOW!!! 


— OPTIONS — 
80287 Math CoProcessor 
Computone Xenix Tape Back Up $999 
30 to 100 MB Hard Drives 
20 to 100 MB Streaming Tape Back (2 minutes per 10 MB) 
CPM®/Z80H Emulator Card Only $395.00 
8MHZ 8088 Slaves (up to 31) for Multi-User 
3 MB Memory Expansion Only $795.00 
Monochrome & Color Monitors 
Basic Xenix® 1024K, 8 Serial, 30MB System $4095 
NO EXTRA CHARGE FOR VISA OR MASTER CHARGE 


CPN is a registered trademark of Digital Research Inc. Hercules is a trademark of Hercules. A T is a trademark of International Business Machines. Velocity 8 and are a trademark 
of Competitive Edge. Screen is PC Paint Brush copyright and product of 2Soft, Inc. Xenix is a trademark of Micro Soft. 


Micro/Systems JouRNAL JANUARY / FEBRUARY 1987 43 


Program Interfacing 
To Microsoft 
Windows 


by William Wong 


Part I—An 
Introduction To 


Windows 
Re a | Be Pe SE | 


Editor's Note: 

Bill Wong concluded his ten part series on “Program Interfacing 
To MS-DOS” in the last issue. Bill now begins a new series on 
program interfacing to Microsoft Windows. 


It is time to take a look at Microsoft Windows, a graphical user 
interface for PC/MS-DOS. Windows is both a user interface and a 
programming environment. This article offers a short description 
of the user interface. Subsequent parts of this series will discuss 
the programming environment. 

Windows requires a graphics adapter such as the CGA, EGA, or 
Hercules card. It supports but does not require a pointing device, 
such as a mouse. The interface uses windows, pull-down menus, 
and icons, similar to those found on the Xerox Star and Apple 
Macintosh. 

W5-D0S Executive | 

§pecial 

End Session 

Create Directory... 

Change Directory... 

Format Data Disk... 

Make System Disk... 

Set Volume Name... 


ABC. THT 


CARDFILE, EXE 
CLIPBRD, EXE 


Figure 1 Reprinted with permission from Microsoft Corp. 
OPERATION 


The top-level Windows screen presents a title and menu line at 
the top of the screen (Figure 1). You can select menus using the 
keyboard or by pointing to a menu title, using a mouse. A pull- 
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down menu is then presented below the menu title. A pull-down 
menu may have a number of selections. By convention, a line in a 
pull-down menu with three dots after the text indicates a subse- 
quent interaction, such as the appearance of a dialog box. This 
feature will be discussed later. 

The center of the top-level Windows screen is called the work 
area. This is the area used by applications. Applications can use 
the entire work area, or only a portion of that area if multiple 
application windows are open at one time. In the latter case, the 
windows are filed. This means that the entire work area will be 
used and that no application windows will overlap. Removing a 
window causes others to expand. The converse is true when a new 
window is added. Pull-down menus and pop-up dialog boxes are 
an exception since they use the work area. 

The bottom of the top-level Windows screen is used to keep 
icons that represent applications that are loaded but do not use 
the screen. An icon represents an application that is not currently 
using a window. Use of icons is a way to keep many applications 
active without cluttering up the screen. You can open an icon into 
a window, within the work area, to use the application. 

You select items and actions in Windows using the mouse or 
the keyboard. You use a cursor of varying form to pick an item. 
The various forms are numerous and are described in the 
Microsoft Windows User’s Guide. The important thing to note, 
at this point, is that it describes an interface that should be fol- 
lowed by all Windows. This consistent interface makes it easier to 
use new and different applications under Windows. Also, Win- 
dows provides support for most of the features used in the top- 
level Windows interface. 

For example, Windows Write, a word-processing application 
provided with Windows, uses pull-down menus, pop-up dialog 
boxes, and windows with scroll bars. A scroll bar appears on the 
right, or bottom edge, of a window; it indicates where in a docu- 
ment the current display appears. It also allows you to move 
rapidly within a document by moving an indicator within the 
scroll bar. Windows provides complete support for things such as 
the scroll bar, including drawing and moving the indicator. The 
application only needs to keep track of the window and the docu- 
ment. This greatly simplifies the development process of a Win- 
dows application. 

Windows offers a nonpreemptive multitasking environment. 
This allows multiple applications to be available at one time. 
Nonpreemptive means that one application will run until it 
wishes to give up the use of the processor. It can let another 
program run by executing an explicit operation, such as delaying 
for a set period of time or waiting for the mouse to select the 
application’s window. Applications that are moved to the icon 
area are normally waiting to be opened into a window. Preemp- 
tive multitasking systems, such as UNIX, split processor time 
among programs through various means, such as time slicing and 
priority mechanisms. 
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B-R-E-A-K Tue DireEcTORY BARRIER 


TURBO PASCAL GENERATOR with DPATH ++ Pus™ 


THE GTP PROFESSIONAL MODEL 


Generate error-free Turbo Pascal source code for: 


DATABASES MENUS 
SCREENS REPORTS 


Build complete, working programs in minutes! 


FEATURES EASY 

Indexed Data Bases 1. Paint-the-screen 

Multiple Screens 2. Define fields & calculations 
Automatic Updating 3. Generate, compile & RUN 

Built-in Edits FLEXIBLE 

Retrieval Facility — 100% Turbo Pascal 

Automatic File Build — Modify in Pascal under Turbo's Editor 
Quick Screen Handling — Extensions are easy with 130 page 
Speedy DB Access Programmer Reference manual 
Context Sensitive HELP — 100 documented source code 

Full Keyboard Support routines included 


@ Run WordStar, dBase, 1-2-3 or any other program 
from any disk directory, without having to copy over- 
lay files, help files, dictionaries, libraries and the like 
into that directory. 

@ Find ANY file for ANY program, even if the program 
wants its files to reside in the current directory. 

@ Output files can even be created in other directories. 

@ Assign directories to pseudo-drives, such as F:, and 
refer to the directory using only the pseudo-drive id. 

@ Protect your hard disk from accidental formatting 
(true IBM compatibles only). 

@ DPATH-+ Plus specs are updatable at any time, even 
while a program is running! 

@ Can be deactivated and later reactivated. 

@ A trace-mode facility allows you to see what file- 
oriented calls any program makes to DOS. 

® Operation is completely transparent to your program. 
Fast — written in assembly language. 

@ Works with hard disks, floppies or RAM disks, in any 

combination. Requires DOS 2.0 or later. Runs in 4-9 

KB of memory, depending on features used. 

Not copy-protected. Can be installed on hard disk. 


NOT Copy Protected NOARoyalty Fees NO Run-time Library Required 


Requires: IBM PC (100% compatible) 256K RAM 2 Disk Drives 
PC-DOS 2,0+ Turbo Pascal 3.0 from Borland International 


PRICE $200.00 
CALL FOR QUANTITY DISCOUNTS 
VISA/MC — Check — Money Order — No COD or Purchase Orders 
Texas Residents: add $12.25 Sales Tax 
Outside US & Canada: add $25.00 Air Postage and make payment by 
credit card or money order in US Funds 


ALLEN, EMERSON & FRANKLIN 


P.O. Box 928 
Katy, TX 77492 
(713) 391-8570 


Personal Business Solutions, Inc 
PO Box 739, Dept P 
Frederick MD 21701 

® 301-865-3376 


60-day money back guarantee! 


*45 + §5 s/h. 
COD add °3. 
Visa/MC/check. 


For S100 bus by S.C. Digital, Inc. 
MODEL 256KMA 


1M DYNAMIC RAM Board Model 256KMA-512 $375 80286 CPU Board Model 80286CPU from $350 


SUPPORT-1 


* 1 Mega bytes © 8/16b data, 24b address ¢ Parity per byte * 175n sec access 
time ¢ will run Z80/Z8000 to 6mhz, 8086 68000 to 8mhz without wait states « 
transparent refresh, unlimited DMA ® works in most systems including Com- 
pupro ¢ with 512KB 


256K/1M DYNAMIC RAM board Model 256KB-256 $325 
* 1 Mega bytes * 8b data, 16/24b address © parity * Memory Mapping in 16K 
blocks, Ideal for Ram Disk, application notes available ¢ addressable in 128K, 
192K, or 256K boundaries ¢ with 256KB 


128K STATIC RAM/EPROM Model128KS $349 noram $169 
© 128K bytes, for 6264 rams or 2764 eproms, can be mixed ® 8/16b data, 24b 
address ® bank select, RAM shadowing, etc. ® ROM simulation in RAM ¢ Bat- 
tery backup with powerfail detector/memory disable, battery holder. 


FLOPPY DISK CONTROLLER board Model FDC-1A $325 
* Single or double density, sides, in any combination of up to four 8", 5%” 
drives * DMA data transfer with cross 64K boundaries, 24b address, DMA 
arbitration ¢ built in monitor/boot ROM that accomodates two different pro- 
cessors ® serial port with hand shakes, up to 19.2K baud ¢ 765A software com- 
patible, compatible with Compupro’s Disk 1A ® with CP/M bios. 


8086 CPU Board Model 8086 CPU $325 
* 8/4 (or 10/5) mhz SW selectable ¢ 8087 interface ¢ provision to run two pro- 
cessors on a bus such as our Z80 CPU ® convertible to 10, 12mhz clock « 
optimized for DRAM boards ° specify clock speed. 


* 8/4 mhz switchable * 80827 interface © provision to run two processors ona 
bus * convertible to 10mhz ® separate built in clock for 80287 © optimized for 
DRAM boards. 


Z80 CPU Model Z80CPU $249 
* 6 or 8mhz, specify * memory mapping in 16K blocks, addressable four 
M bytes. 


SUPPORT Board Model Support-1 $325 
4 serial, full handshakes, two with software programmable baud rates * Cen- 
tronics * SAS! interface * Real/interval timers * Calendar-clock with battery 
backup * expandable interrupt controllers for 8086 or 8080/Z80 * CPU 
switching circuit to run 2 processors on a bus such as our 8086 or 80286 and 
Z80 CPU boards. 


1/O Interface Board Model 3SPC-N $229 
* 3 serial RS-232C with switch selectable baud rates, 110 to 19.2K baud. ¢ 
1 parallel. 


256K STATIC RAM Board Model 256KS $375 
* 256K bytes * 8/16b data, 24b address ® can be loaded in 16Kb increments * 
fast access time: will run in access of 10mhz when fully loaded with 150nsec 
chips ¢ Battery backup with power fail detector/memory disable, battery 
holder * w/ 256KB, less battery. 
Please call for latest prices. 
Prices subject to change without notice. 


S.C. DIGITAL, INC. 
1240 N. HIGHLAND AVE., SUITE 4 ® P.O. BOX 906, AURORA, ILLINOIS 60507 
PHONE: (312) 897-7749 
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APPLICATIONS 

Applications come in two forms: conventional DOS applications 
and Window applications. Windows allows conventional DOS 
applications to run, but these applications normally will not use 
any of Window’s extended features and may have to use the en- 
tire screen. Also, the application will often have to be terminated 
to run another application. 

Applications can be swapped out to disk to leave more room for 
additional applications. An application will be swapped in by Win- 
dows when it is active, if it is not already resident. Swapping for a 
non-Windows application is automatic and controlled using .PIF 
files, which will be discussed later. Unfortunately, the entire area 
used by this type of application is swapped. Windows applications 
can make use of the Windows memory manager for more control, 
because the application has control over each allocated segment. 
Some can be resident while others are transient. Although this 
technique is not the same as virtual memory, offers a better solu- 
tion than implementing such a system within an application. 


CONFIGURING WINDOWS 

The initial Windows configuration is specified using a text file 
called WIN.INI, which is read by Windows when it is loaded. The 
file is divided into a number of sections. The settings within the 
file are used by Windows and are also available to other applica- 
tions through Window’s supplied functions, to be discussed in a 
later article. The following syntax is used within the WIN.INI file: 


[section] 
keyword=value 


The section can be any name and may be specific to an applica- 
tion. The keyword and value pairs can be any text. Many values 
can be included with one keyword and are usually separated by 
commas. An application refers to the values using the section and 
keyword. An example of part of the standard WIN.INI file is: 


[Windows] 
DoubleClickSpeed=500 
CursorBlinkRate=450 
Device=Epson FX-80,epson,LPT1: 
Load=clock 
SwapSize=0 
SwapDisk=E 

[Ports] 
COM1:=9600,n,8,1,p 


Windows uses a number of sections, including the one listed 
above. Applications can be loaded by default using the Load 
keyword. This allows you to have your standard configuration set 
up when you enter Windows. SwapDisk refers to the disk to be 
used when an application needs to be swapped out. SwapSize is 
the number of kilobytes to be used for the swap file. A zero (0) 
indicates that the size is to be taken from the first application to 
be swapped out. 

Logical and physical Window devices can be indicated in the 
Devices and Ports sections. These sections are often used by 
applications to determine what devices are available for use. A 
Program Information section, [PIF], is used to specify what sys- 
tem resources an application needs, or uses. This is important 
because some non-Windows-specific programs may have differ- 
ent needs, which cannot be set up by the program. The [PIF] 
section normally contains a list of programs and the required 
amount of memory in kilobytes. 


PIF FILES 

In addition, Windows recognizes .PIF files. These files are created 
and manipulated using PIFEDIT.EXE, a standard Windows sup- 
port application. A .PIF file contains information about a pro- 
gram, its parameters, the initial directory in which it should run, 
memory requirements, screen usage, and direct-device usage. 
The latter allows Windows to recover if, for example, the commu- 
nications port is set directly by an application. 


The screen-usage characteristics are important because they 
may allow a non-Windows application to run within a window. 
Those characteristics also indicate memory requirements for 
applications in which screen capture, or a screen dump, may be 
available. High-resolution screen-display adapters require more 
memory to save the screen than low-resolution display adapters. 


WINDOWS APPLICATIONS 

Three Windows applications included with Windows are the 
spooler, the control panel, and the clipboard. The spooler allows 
spooling and redirecting printer output. The control panel allows 
general Windows attributes to be examined and modified. These 
applications utilize the Windows environment and available win- 
dowing functions. The clipboard application allows exchange of 
text and graphics between other applications. The actual mecha- 
nism and its limitations is quite extensive and will not be covered 
here. Windows is often supplied with other Windows-based 
applications. 


DYNAMIC DATA EXCHANGE 

Another Windows-specific feature is called DDE (Dynamic Data 
Exchange). DDE is a protocol that uses Windows functions to 
allow applications to communicate with each other by name. 
Most current Windows applications do not support DDE, but 
some newer applications do include DDE support. The DDE proto- 
col will be discussed in more detail in a later article. 

A sample scenario would be a communications program that 
included a DDE hook so that information from an on-line service, 
like Dow Jones, could be made available. A spreadsheet program 
could use this hook to get information to present real-time results. 
The spreadsheet could also be hooked to a graphing program, 
which would take these results and present a graph in a window, 
which could then be updated as new results were available. All 
three applications would need a DDE interface. The communica- 
tions program would advertise the existence of the on-line in- 
formation. The spreadsheet would have to access this information 
and advertise the availability of the results, and the graphing 
program would have to access the results. 


NAMING CONVENTIONS 

Windows is a large and complex piece of software. This article 
and subsequent articles will use the same naming conventions as 
are used in the Microsoft documentation. Examples will be writ- 
ten in C for consistency. First, there are the simple data types: 


Prefix Type Description 
ce char 8-bit character 
b  ~=BOOL 8-bit Boolean 
(0 is false, nonzero is true) 
int 16-bit integer 
(default if prefix) 
] LONG 32-bit integer 
1 long same as LONG 
f BYTE 8-bit unsigned integer 
w WORD 16-bit unsigned integer 
dw DWORD 32-bit unsigned integer 
h HANDLE 16-bit unsigned integer 
p NEAR 16-bit pointer 
Ip FAR 32-bit pointer 
pt POINT 32-bit coordinate (X, Y) 
two 16-bit numbers 
rgb RGB 32-bit RGB color value 
R+(G+*256)+(B*256+*256) 
POINTERS AND HANDLES 


Pointers and handles actually come in several different forms. 
They are listed here and will be used in definitions in later arti- 
cles. Like the previous types, these new types use the same prefix 
convention, except the type name is capitalized. 
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Type Description 


PSTR NEAR pointer to character string 
PINT NEAR pointer to signed 16-bit integer 
LPSTR FAR pointer to character string 
LPINT FAR pointer to signed 16-bit integer 
LPRECT FAR pointer to RECT 

LPMSG FAR pointer to MSG 

FARPROC FAR pointer to a function 

HWND HANDLE to a window 

HSTR HANDLE to string resource 
HCURSOR HANDLE to cursor resource 
HICON HANDLE to icon resource 

HMENU HANDLE to menu resource 

HDC HANDLE to display context 

HPEN HANDLE to physical pen 

HFONT HANDLE to physical font 

HBRUSH HANDLE to physical brush 
HBITMAP HANDLE to physical bitmap 
HRGN HANDLE to physical region 
GLOBALHANDLE HANDLE to global memory 


LOCALHANDLE HANDLE to local memory 


Of course, the pointers introduced a couple of new structures. 
These are listed here: 


typedef struct 
{ int x 3 
int y ; 


POINT ; 
typedef struct 
{ int left 

int top ; 
int right 
int bottom ; 


' 


} 


RECT ; 

typedef struct 
{ HWND hwnd ; 
WORD message 
WORD wParam 
LONG 1Param 
DWORD time 

POINT pt 


MSG 


, 
’ 
’ 
’ 
’ 


, 


POINT and RECT have obvious uses and definitions. MSG, on 
the other hand, is specific to Windows. It is a structure used to send 
a message between windows, which is the way applications can 
communicate with each other and with Windows. The elements of 
the structure are: the window receiving the message; a message 
number; a WORD and LONG parameter whose meaning is speci- 
fied by the message number; the time the message was posted; and 
the mouse position, listed in screen coordinates, when the message 
was posted. The actual use of this structure will be covered in the 
next article, which discusses basic window functions. 


LOOKING TO THE FUTURE 

As you may have guessed, Windows is driven by handles and 
pointers just like DOS, except handles are no longer just for files. 
The way these items are used will become clear in the following 
articles, so stay tuned. These articles will address the support 
functions for Windows; the Graphics Device Interface (GDI); and 
system resources, which include managers and functions for mod- 
ules, memory, tasks, resources, atoms, communications, sound, 
and access to the WIN.INI file. § 


Bill Wong is president of Logic Fusion, Inc., 1333 Moon Dr., 
Yardley, PA 19067, a systems software development firm. 


What you see is what you get 
Transfer Protocol: Modem?/CRC Packet Size: 


We ol bl 


Errors! 

Status: sranster in progress 
Fila Transfer 
SANYFILE, AQC 


Sending: 


and send! 


128 Files: i 


Remaining |Consec 


[CTL to abort] 


Announcing Version 1.6 of MEX, the communications software with a view from the top. Regardless of your level of 


sophistication, MEX can put you on top of the data transfer game and keep you there. For the executive on the go, our new 
pull-down transfer screen and easy-to-use menus reduce the complexities of modem communications to. a few keystrokes. 
For the advanced user, MEX’s greatly enhanced script processor offers a complete programming language for development 
of highly secure custom applications. If Communication is money in your business, MEX may be the best investment you 
make this vear. 


Two options available: 

MEX-PC is the most complete modem software you can buy. Allows you to switch 
between menu-driven and command-driven communications at will. Makes full use 
of Hayes AT command set, with overlays available for most other modems. Features 
include: complete script processor programming language; user-definable keystrings; 
auto-dial and auto-baud-set phone libraries; all popular protocols, including 
MODEM-7 batch transfers $59.95* 


XMODEM CRC/XMODEM CHECKSUM/KERMIT/COMPUSERVE A/128 or 1K BLOCKS 
s 
MasterCard, VISA welcome Give usa toll-free eall at 


In Wi in, 1-414-563-4013 
* plus shipping; Wisconsin residents add 5% sales tax 1 =-2 O O-NITEOWL wlan Box 7, Ft. Atkinson, WI 53538 
See 5, aa Fe i ESS SE ip gen eam Fe | 


MEX-PAC — All the features of MEX-PC, plus 


()A remote module that allows you to run your office computer from home, and vice 
versa; and 

()Terminal emulation that lets your PC masquerade as a DEC VT52/100 or Televideo 
925 terminal for on-line communication with mainframes. $99.95* 


Versions available for IBM-PC and compatibles, Tandy 2000 and most CP/M machines. 
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MICRO 
SUP RLY 


ORGANIZATION INC. 


Don't be fooled. 


No hidden cost! 


Complete MS-DOS/CPM 
Super Turbo 


In keeping with industry trends MSO is 
bringing our customers high 
performance P.C. compatibles and 
accessories. MSO takes the P.C. 
compatible to maximum performance 
with its SUPER TURBO. The SUPER 
TURBO features the V20-8 chip which 
runs at three times the speed of the 
IBM-PC XT* and also runs CPM 8080 
software. 

The SUPER TURBO comes complete 
with the MS-DOS operating system, 
Read and Run CPM, full Instructional 
Documentation, Utility software, plus 
for our first 100 customers MSO is 
offering the Micropro Wordstar 
Professional Software package. 
This package includes: Wordstar, 
Mailmerge, Correctstar, Starindex, 
Datastar and a G.L. Accounting 
System. The SUPER TURBO is a 
complete turnkey system with 
everything necessary to plug in and 
operate. 


USER SUPPORT 
HOT LINE 


805/393-2247 


All systems carry full 90 day warranty. 


CASH PRICE ONLY 


Check in advance. Add 3% for VISA/MC. Shipping 

& handling charges will be added to each order 

For our catalog with complete details and 
prices, send $2.00 to: 


Micro Supply Organization, Inc. 
4909 Stockdale Hwy. #180 
Bakersfield, CA 93309 


MON. - FRI. 7am - 5pm PSTeSAT. 9am - 5pm PST 
“IBM is a registered trademark of the IBM Corporation 
15% restocking on returned orders 


Super Turbo 
Super Price: 


$1299 


HVESO} 


mn 


are to 
compare. 


all 


The Super Turbo P.C. runs IBM 
software and CPM 8080 programs 


CPU - V20-8 8mHz Super Chip runs *IBM 
compatible software at 3 times the speed 
of the IBM-XT and CP/M 8080 software. 
8087 Math Processor optional 

256K RAM on mother board expandable to 
640K 

ROM 8K Bios 

6 empty slots for expansion 

2 serial port one optional with expansion 
kit 

1 parallel port 

1 game port 

Clock calendar with software 

Hi-Res monographics video board 

Floppy controller 

Dual Floppy Drives 360K ea. 

135 watt XT Power Supply 

5150 style compatible keyboard 

Hi-Res TTL Green or Amber 12” monitor 
MS-DOS operating system and manual. 
Instructional Documentation and Utility 
Software 

Assembled and tested in U.S.A. 
Optional internal 20 meg sub 
system for Super Turbo add $499 


Special printer 
pricing with 
purchase of 
above computer. 
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MICRO 


a Opt el 


ORGANIZATION INC. 


MSO, the leader in cost effective computer 
systems, is offering the Sanyo MBC 1200 
at a giveaway price! 


The MBC 1200 Accounting Software 
-G/L, A/R, A/P, Inventory and Payroll 
modules retail for $398 per module. Now 
from MSO you pay only $99 per 
module or all five for $299! Second 
disk drive with fan-option available. 
COMPAT disk utility available. 


SPECIFICATIONS: 

Two Z-80A (main and subsidiary) CPUs with no- 
wait mode for fast execution, substantial 
memory capacity (RAM 64KB, ROM 4KB) 

¢ High-resolution full graphic function with 640 x 
400 dot matrix display. 

*Choice of 33 or 40 line text mode. 

¢CP/M operating system complete with 
interpreter, editor and all utilities 

* Easy-to-use Sanyo graphic BASIC. 

*One (MBC 1200) or two (MBC 1250) internal 
double-sided, double-density, double-track, 5%" 
slim-type 640KB formatted mini floppy disk 
drives. 

¢Special design featuring detachable ergonomic 
keyboard with coiled cable 

¢lnterfaces for Centronics printer and one RS- 
232C port provided. 


20 meg internal hard drive sub- 
system for Sanyo MBC 1100, 


1160 & 1200 
$599 (with purchase) 


Printer specials with purchase 


805/393-2247 


All systems carry full 90 day warranty 

CASH PRICE ONLY 

Check in advance. Add 3 tor VISA/IMC. Shipping 
& handling charges will be added to each order 


For our catalog with complete details 
and prices, send $2 to: 


Micro Supply Organization, Inc. — — 
4909 Stockdale Hwy. #180 VISA Faseneud 
Bakersfield. CA 93309 == 4 


15% Restocking on Returned Orders 
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the 
giveaway. 


iS SANYO 
MBC 1200 


FREE SOFTWARE 


e Wordstar ¢ Spellstar 


e Calcstar ¢ Mailmerge 
e Infostar ¢ Basic 


*399 
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DeSmet C 


— now with — 


LARGE MEMORY 
OPTION 


C88 Compiler $109 


Full K&R + V7 extensions 
inline asm 

assembler, linker, librarian 
full screen editor (SEE'), 
8087 & S/W floating point 


D88 Debugger $50 


Set Breakpoints by line number 
or function name 

Examine Global/Local variables 
by name 

Show C source while debugging 

Both D88 and User displays 


Large Memory $50 
Model Option 
32-Bit Pointers (Full Megabyte 
Addressing) 


Fast Access of Static Data 
Works with D88 


— plus — 
DOS Link $35 
convert to .OB4J files 


Graphics (+src) $35 


Hacker $25 
source for start-up, 
RAM.COM & more 
Make $50 
full UNIX-level 


Tools (+source) $35 


XARRAY $39 
Large Arrays (+source) 


C WARE 


CORPORATION 


505 W. OLIVE, SUITE 767 
SUNNYVALE, CA 94086 USA 
(408) 720-9696 TELEX: 358185 
We accept 
VISA, MC & American Express 


FIGURES & CODE FOR MARSHALL BRAIN ARTICLE - Experimenting With 
Protected Mode On The AT 


Figure 1 - Sequence of events used whenever a new value is loaded into 
a segment register. 


| 1) DS is loaded with new value. 
| 


Vv 
ee +p—-—-------------~-------------------- + 
DS | 20H | (invisible 8 byte descriptor cache) |<----- + 3)Cache is 
+------ pm en a rrr + loaded 
| with new 
| descrip- 
| tor. 
Vv 


2) High order 13 bits and 
3 low order zeros 
(in this case the 3 low 
order bits are already 
0) are used as index into 
table. | 


The GDT is a table 

of 8 byte descriptors. 
The starting address of 
each descriptor is on 
an 8 byte boundry. 


Figure 2 - On the 80286, a segment register consists of the 16 byte 
segment register found on the 8088, as well as 8 bytes of cached 
information from a descriptor table. The individual bits of each of 
these values are defined as shown. 


Segment register - 


to----------------- tante--a+ 
| INDEX |TI|RPL | 
$------------------ +--+----+ 
15 32 1 (0) 

Bits Name Description 

0-1 RPL Requested Privilege Level. 

2 TI Table Index. O=GDT, 1=LDT. Tells 


the 80286 which table to get the 
descriptor from. 

3-15 INDEX Index into the descriptor table. Three 
zeros are placed in the 3 low order 
bits when the table is actually indexed. 


Memory Descriptor - 


ta---- t+----- t----- $----- +----- to---- fo---- ta---- + 
| RESERVED |RGHTS| BASE | LIMIT 
te---- +----- t----- +----- to---- +----- +----- fa---- + 
byte 5 6 5 4 3 2 1 10) 
Bytes Name Description 
0-1 LIMIT Maximum size of the segment. 1 to 64K bytes. 
2-4 BASE Location of the segment in physical memory. This 


is a 24 bit value to allow addressing across the 
entire 16 Meg address space. 

5 RGHTS Access rights byte. See below. 

6-7 RESERVED Reserved for use on the 80386. 


Access Rights Byte for a data segment- 
tatatatetat—tete—t 
|P|DPL{1|/E|X|WIA| 
tatatotetetitet—t 

Bit 76543210 
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Name 


0 Accessed 
1 Writeable 


Description 


1 Indicates that segment has been accessed. 
For a data segment, l=writeable, 0=read only. 


For a code segment (bit 3 = 1), l=readable, 
O=execute only. 


2 eXpansion 
3 Executable 
4 
5-6 DPL 

7 Present 


1=expand down, O=expand up. 

1=executable segment, O=data segment 

Indicates Memory descriptor (as opposed to Control) 
Descriptor privilege level. 

Indicates that segment is present in memory. 


1=Present. 


Divide Error 


INTO Overflow 


Single Step interrupt 
Non-Maskable interrupt 
Breakpoint interrupt 


Invalid Opcode exception 
Processor Extension Unavailable 
Double Exception Detected 
Processor Extension Segment Overrun 
10 Invalid Task State Segment 
11 Segment Not Present 
12 Stack Segment Overflow or Not Present 
13 General Protection Error 


*=same as 8088 


ie} 
i. 
2 
3 
4 
5 Bound Range Exceeded exception 
6 
a 
8 
9 


Figure 4 - Segments expected to be found in the GDT by the AT BIOS 
call Interrupt 15H, function 89H. 


Number Name 
0 Dummy 
1 GDT Alias 
2 IDT Alias 
3 Data Seg 
4 Extra Seg 
5 Stack Seg 
6 User Code Seg 
7 BIOS Code Seg 


Description 

Segment 0 is invalid, so initialize to 0. 
Since the GDT is itself a segment, there 
must be a descriptor available if it is to 
be changed. A descriptor created to access a 
segment that would not normally be 
accessible is called an "alias". 

Alias for interrupt table. 

Descriptor to point to the user's data 
segment. 

Descriptor to point to user's extra segment. 
Descriptor to point to user's stack segment. 
Descriptor to point to user's code segment. 
The BIOS routine fills this descriptor so 
that its code can continue executing once 
the jump to protected mode occurs. Once in 
protected mode, the BIOS routine loads the 
segment registers with the user defined 
values, and then jumps to the user's code. 


FPFFPBAABEB AEE FEBFLEEEFEEFEEEEEEELEEEPEEEPLEFE FEEL ELE EA ELSEIF AFB FE 


CODE STARTS HERE 


program protected mode_and_back; 


{$u-,k-} 


{Marshall Brain 


Version 1.0 


{These directives MUST be set off like this} 


September 15, 1986} 


{This program demonstrates what is required to go into protected 
mode, and then come back to real mode. Interrupt 15, function 
89 is used to get into protected mode. See article or AT ROM BIOS 


listing for details. 


The program will beep once (low tone) from protected mode and 
return to DOS if everything works correctly. A processor fault 
will cause 2 beeps (high tone) and halt the system.} 
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LOOKING FOR 
“Ni ET” 


RESULTS? 
EARTH COMPUTERS 
has the 
solution 
to your 
Networking 
problems. 


ens Ghw 


EARTHNET-Pc.”™ 


EARTHNET-PC is the most flexible net- 
working card on the market. It has been 
designed for high performance and 
maximum functionality. 


EARTHNET-PC is fully compatible with 
SMC networking cards and runs popular 
networking software such as NOVELL’s 
NETWARE, ViaNet, and TurboDOS, all of 
which support the new LAN Standard 
and DOS 3.1 record locking. 


EARTHNET-PC’s 5-2 inch card fits in 
any short slot of an IBM-PC/XT or com- 
patible system and uses advanced 
Token-Passing technology. Data trans- 
fers are made at 2.5 Megabytes per 
second. 


YOU CAN STOP SEARCHING...EARTH- 
NET-PC IS THE SOLUTION TO YOUR 
NETWORKING PROBLEMS! Order 
your EARTH-NET-PC today! Call EARTH 
COMPUTERS, the company that’s set- 
ting the standard for LAN standards. 


ATTENTION DEALERS! If you've been 
searching for ways to increase your 
NETworking profits, call EARTH COM- 
PUTERS and find out about our attrac- 
tive, profit-generating dealer program. 


EARTHNET-PC is a trademark of EARTH COMPUTERS 
NETWARE is a trademark of Novell 

ViaNet is a trademark of Vianetix, Inc. 

TurboDOS is a trademark of Software 2000 
IBM-PC/XT is a trademark of International Business 
Machines, Inc. 


Se en 
- — - — —— 
EARTH COMPUTERS _ 
—=S ~:~ Ct 
a 


P.O. Box 8067, Fountain Valley, CA 92728 
TELEX: 910 997 6120 EARTH FV 


(714) 964-5784 


Ask about EARTH COMPUTERS’ other 
fine PC and S-100 compatible products. 
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Ae ) 
If You Coul 
Hear The 
Language 

They’re Using! 


What they're saying would astound you. 


They’ve switched from BASIC, and PASCAL, 
and a host of other languages and even stand-alone 
database programs. 


They’ve switched to COMP Computing Standard 
MUMPS...CCSM, the Database Language. 


“The best software product of its kind, that I 
have come in contact with.”” Computer Language 
Magazine 


“T’ve found the best in CCSM...fast in develop- 
ment and fast in execution...no data-typing 
problems, no concerns for program size, no 
concerns for file or device opens...” R.D. 
Ashworth, Ph.D. 


“...5 years in Basic, Pascal, C, dBase, and 
Dataflex... | have never worked with a lang- 
uage/programming environment as responsive, 
easy to use and as powerful as CCSM”’ P.K. 
Wayne, MD, Ph.D. 


CCSM, the Database Language is a powerful, 
flexible string-oriented language, with the features 
of a complete development and operating system. 
Typical programs are written in 1/3 to 1/5 the 
amount of code, compared to BASIC or PASCAL. 


Multi-Tasking Available, Too! 

CCSM, the Database Language offers a true 
multi-tasking option. Run multiple, concurrent 
background processes for data searches, report 
generation, etc. 


Order CCSM, the Database Language today. 


In a very short time, you'll be surprised at the 
language you're using. 


IBM's and compatibles...128K min. 


1-800-257-8052 


in Texas 713-529-2576 


MGlobal 


1601 Westheimer, Suite 201 
Houston, TX 77006 
AMEX, VISA AND MC accepted by phone 


tee User disk and operations maual $59.95 
"CookBook of MUMPS" (includes disk) $24.95 
SPECIAL Single user & "Cookbook" $75.9C 

Multi-taskin $149.95 


Disks are Programmer's Toolkit $49.95 
not copy Graphics option $49.95 
protected Multi-user $450.00 


MacMUMPS (Macintosh version) $149.95 
Shipping and handling $3.00 
Texas residents add 6 1/8% sales tax 
IBM is a trademark of International Business Machines; 
Macintosh is a trademark licensed to Apple Computer 
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const 
gdt_size=8; {Max number of descriptors in GDT minus 1} 
idt_size=13; {Max number of descriptors in IDT minus 1} 
code _desc={6*8}48; {Code segment selector is #6 in GDT} 
const {typed constants are variables in the code segment} 
data_seg:integer = 0; {storage space for segment registers} 
stack_seg:integer = 0; 
extra_seg:integer = 0; 
type 
descriptor=record 
seg_limit:integer; 
base_lo word:integer; 
base_hi_byte:byte; 
data_acc_rights:byte; 
data_reserved: integer 
end; 
string80=string[80]; 
var 
gdt:array[0..gdt_size] of descriptor; {Global descriptor table} 
idt:array(0..idt_size] of descriptor; {interrupt dscrptr table} 
result:record ax,bx,cx,dx,bp,si,di,ds,es,flags:integer; end; 
mask1_8259,mask2_8259:byte; {storage space for 8259 masks} 
screen:array[0..$2000] of byte absolute $40:0; 


{from AT Bios listing} 
{segment limit (1-65536 bytes) } 
{ 24 bit physical address (0-(16M-1))} 


{access rights byte} 
{reserved for 80386 compatability} 


procedure setup error; 
{Displays a message if you try to setup a descriptor outside the 
boundries of a descriptor table.} 
begin 
writeln;writeln('There has been an error during setup of 
‘descriptor tables.'); 
halt; 
end; 


procedure set_gdt_desc (num, seg_lim,base_lo:integer; 
base _hi,acc_rights:byte); 
{This procedure sets up descriptor number NUM in the GDT with the 
values that are passed.} 
begin 
if (mum>=0) and (num<=gdt_size) then 
begin 
with gdt[num] do 
begin 
seg_limit:=seg_lim; 
base_lo_word:=base_lo; 
base_hi_byte:=base_hi; 
data_acc_rights:=acc_rights; 
data_reserved:=0; 
end; 
end else setup error; 
end; 


procedure set_idt_desc (num, seg_lim,base_lo:integer; 
base_hi,acc_rights:byte) ; 
{This procedure sets up descriptor number NUM in the IDT with the 
values that are passed. } 


begin 
if (num>=0) and (num<=idt_size) then 
begin 
with idt[{num] do 
begin 


seg_limit:=seg_lim; 
base_lo word:=base_1lo; 
base_hi_byte:=base_hi; 
data_acc rights:=acc_rights; 
data_reserved:=0; 
end; 
end else setup _error; 
end; 


procedure beep; 
{beeps the speaker. } 
begin 
sound (300) ; delay (400) ;nosound; delay (400) ; 
end; 


procedure errbeep; 
begin 

sound (2000) ; delay (400) ; nosound; delay (400) ; 
end; 
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procedure fault; 
{This routine is entered if a processor fault occurs while in 
protected mode. } 
begin 
errbeep; 
errbeep; 
{pop the 4 words put on the stack when fault occured.} 
inline ($Sb/$5b/$5b/$5b); {pop BX 4 times.} 
port [$64]:=$fe; {return to real mode} 
inline (S$f£4); {Halt to wait for reset to take effect.} 
end; 


procedure setup _idt; 
{this procedure loads the idt with the appropriate values to handle 
all 80286 processor faults.} 
var x:integer; 
abegin 
{The first 14 selectors are all 80286 faults, and are directed to 
the fault routine for now.} 
set_idt_desc(0,ofs (fault) +7,code_ desc, 0,$86); 
set_idt_desc(1,ofs(fault)+7,code_desc, 0, $86); 
set_idt_desc(2,ofs(fault)+7,code desc, 0, $86); 
set_idt_desc(3,ofs(fault)+7,code_desc, 0, $86) ; 
set_idt_desc(4,ofs (fault) +7,code_ desc, 0, $86); 
set_idt_desc(5,ofs (fault) +7,code_desc,0, $86); 
set_idt_desc(6,ofs(fault)+7,code_ desc, 0, $86); 
set_idt_desc(7,ofs (fault) +7, code_desc,0, $86); 
set_idt_desc(8,ofs (fault) +7,code_desc, 0, $86); 
set_idt_desc(9,ofs (fault) +7,code_desc, 0, $86) ; 
set_idt_desc(10,ofs (fault) +7,code_desc,0, $86); 
set_idt_desc(11,ofs (fault) +7,code_desc,0, $86); 
set_idt_desc(12,ofs (fault) +7,code_desc,0,$86) ; 
set_idt_desc(13,ofs (fault) +7,code_desc,0, $86); 
end; 


System Manager PC 
List Price $375 
Complete PC /Compatible 
Network Security Package 


« All menu driven 
« Restrict drive and directories 

+ Log ON/Log Off record keeping 

* Full electronic mail 

* Display system status 

¢ Talk-send messages to another processor 
« Acct. manager-menu driven acct. editor 

« Runs on all PC’s/compatible’s 


procedure addr24 (segment,offset:integer; var a24w:integer; var a24b:byte); 
{To work in protected mode, physical addresses must be expressed 

in 24 bit values. Addr24 puts the lower 16 bits of the 24 

bit address in a24w, and puts the upper 8 bits in a24b.} 
var x:integer;y:byte; 


begin 
inline( 
Heche ha auld ined = pena: si etie mpm awe 44 el We support large TurboDOS systems 
a = = offset [bp]; add offset and send with multiple ASTRED 
Sea inde ae e ' ago - We support the following OEM’s 
$89/886/%); {mov x{bp],ax 7 save result } ICD ICM Earth Computers 

at aia =y; L/F Technologies Teleteck 


procedure setup gdt; 

{This procedure sets up the GDT with the descriptors required by 
Int 15, function 89.} 

var a24w:integer;a24b:byte; {24 bit physical addr storage} 

begin 


. Dealer discounts Aa 


{# Function } 
set_gdt_desc(0,0,0,0,0);7 {0 dummy descriptor} 
addr24 (dseg, ofs(gdt) ,a24w, a24b) ; 
set_gdt_desc(1,sizeof(gdt),a24w,a24b,$92); {1 GDT alias } 
addr24 (dseg,ofs(idt),a24w,a24b) ; 
set_gdt_desc(2,sizeof(idt),a24w,a24b,$92); {2 IDT alias } 
addr24 (dseg,0,a24w, a24b) ; 
set_gdt_desc(3,$ffff,a24w, a24b, $92) ; {3 Data descriptor } odden 
set_gdt_desc(4,$ffff,a24w, a24b, $92); {4 Extra descriptor} 
addr24 (sseg,0,a24w, a24b) ; 
set_gdt_desc(5, $£fff,a24w, a24b, $92) ; {5 Stack descriptor] echnology 
addr24 (cseg,0,a24w,a24b) ; 
set_gdt_desc(6,$ffff,a24w, a24b, $9a) ; {6 Code descriptor } imited 
set_gdt_desc(7,0,0,0,0); {7 Temp Bios CS } 


{the following is an additional descr used to access the screen. } 

addr24 ($b800,0,a24w, a24b) ; 

set_gdt_desc(8,$2000,a24w, a24b, $92) ; {8 Screen descriptor } 
end; 


2834 N. Mitford Rd. 
Mifford, Ml 48042 
(313) 685-8538 ORDER 
(313) 685-3877 TECH 
(313) 685-7947 COMPUTER LINE 


TurboDOS is a registered trade mark of Software 2000, Inc. System 
Manager Lodden Technology Ltd. 


procedure save segs; 

{Saves the current segment values in typed constants so they can 
be retrieved when program returns from protected mode. } 

begin 
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data_seg:=dseg; 

extra_seg:=dseg; 

stack_seg:=sseg; 
end; 


procedure save 8259 regs; 

{Saves current 8259 masks so they can be replaced on return to 
real mode.} 

begin 
mask1_8259:=port [$21]; 
mMask2_8259:=port [$al]; 

end; 


procedure set_cmos_for shutdown; 

{sets cmos ram so that the reset that brings this program back to 
DOS jumps to the correct address in this program.} 

begin 
port [$70] :=S0f; 
port [$71] :=$05; 

end; 


procedure protected _ mode exitpoint; 
{When program returns to real mode, if comes here.} 


begin 

{recover segment registers} 

inline( 
$2E/SAl1/data_seg/ {mov ax,cs:data_seg } 
S8E/S$D8/ {mov ds,ax } 
$2E/SAl1/extra_seg/ {mov ax,cs:extra_seg} 
$8E/$CO/ {mov es,ax } 
$2E/$Al1/stack_seg/ {mov ax,cs:stack_seg} 
$8E/$DO) ; {mov ss,ax } 


{reset 8259 masks} 


IEEE 488 TO S-100 port [$21] askl 8259; 


port [$al] :=mask2_8259; 
INTERFACE {when this procedure returns, it will return to the place where 
goto protected_mode was called from (see last line of pgm) -} 
end; 


procedure setup jump locations; 

{set up appropriate memory locations with address of routine 
to use when returning to real mode. } 

begin 
memw [$0040:$67]:=ofs (protected_mode_exitpoint) +7; 


Controls IEEE 488 (HP1B) a 
Instruments with an 


57100 ¢ » 488 


procedure display (col, row:byte;1n:string80) ; 
{routine to display information on the screen by writing directly 


S-100 computer 
Acts as controller or aaa Col, row express the coords that LN should be 


device var x,addr:integer; 
: begi 
Basic and assembly ada 


addr :=row*80+col; 

; . for x:=0 to length(ln)-1 do 
language drivers supplied screen[ (xtaddr) *2] :=ord(1n[x+1]); 
Meets IEEE 696 end; 
specification procedure test_screen; 


Industrial quality burned {writes a message on the screen.} 


var x:integer; 


in and tested up to 125K begin 

f c= lto5sd 
bytes/sec under software "SLSpIAMS Ox, ‘HELLO FROM PROTECTED MODE. '); 
control 3 parallel ports end; 


(8255-5) procedure goto protected mode; 

$375 {Take program into protected mode and perform whatever routines 
are needed while in protected mode. Returns to real mode when 

done. Do not use any turbo function requiring BP register in this 


routine. } 
begin 
{Call interrupt 15, function 89} 
inline ( {ao interrupt 15n, LCunction 69h to get lo protected mode} 
$8c/$d8/ {mov ax,ds } {load address of GDT into es:si} 
$8e/$c0/ {mov es,ax } 
Sbe/gdt/ {mov si,ofs (gdt) } 
$b7/$08/ {mov bh, 8} {bh,bl contain new location for} 
$b3/$08/ {mov bl,8} {hardware interrupt vectors} 
D&W DIGITAL, INC. $b4/$89/ {mov ah, 89h} 
20655 Hathaway Avenue poupnnred pores 


Hayward, California 94541 
(415) 887-5711 
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POPPY. A true multi-user computer. 


harter Information’s POPPY is 
a new variety that will make 
your office blossom. 

POPPY handles all facets of 
your business — purchasing, 
sales analysis, and general 

ledger functions. Accounts payable, inven- 
tory control, materials requirements plann- 
ing, and payroll. Plus desktop publishing 
and a host of other wonderful things that 
you need to do. 

POPPY consists of a processor board, 
SmartCable, keyboard, and monitor. Plant 
multiple POPPY boards in a System 4 and 
watch your productivity bloom. 

POPPY runs programs that operate on 
an IBM PC, including those that use 
graphics. And when it comes to dazzling 
displays, POPPY provides text and 
graphics in both color and black and 
white. Roses pale in comparison. Each 
POPPY has its own processor, one that is 
powerful enough to make a PC wilt. So 
you get to see what you want to see and do 
what you need to do as soon as you are 
ready. 

What is really outstanding is POPPY’s 
ability to fit in. The System 4 gives POPPY 
access to shared hard and soft disk drives, 
tape drives, printers and other devices. All 
under the control of a master processor 
that fulfills each POPPY’s every need. The 
master takes care of spooled printing, con- 
trolled access to discs, file and record locks 
and operation of printers. 


POPPY is no garden variety product. 


If you are looking for a rainbow of colors to 
make your business ideas look better, wait until 
you see what POPPY can do — for all your users. 
You see, unlike standalone computers which re- 
quire separate cards for each graphics mode, 
POPPY provides all the most popular graphics 
modes as standard equipment. It lets you switch 
among them through software — no fumbling 
with tiny dipswitches. That includes mono- 
chrome, color, EGA and Hercules graphics. 


It’s no wall flower, POPPY communicates. 


Each POPPY comes with a PC compatible 
serial port. That means that each user can have 
a serial printer, a mouse or an external modem 
of its very own. And there is an optional 
1200/2400 baud modem built in, if you specify 
it. Rooted in the S-100 technology of the System 
4, communications between your users and 
shared information is faster than summer light- 
ning. And that cultivates user productivity like 
never before. 


How did they do it? 


The designers of POPPY and 
System 4 have had years of ex- 
perience implementing multi-user 
installations, in both manufactur- 
ing and office situations. They 
realize that multi-user en- 
vironments demand something 
more than just another garden va- 
riety machine to insure adequate 
throughput and make information 
sharing practical among all your 
users. So, they created a multiple 
processor system. Every POPPY 
has its own processor and mem- 
ory. Then, using the fastest communications 
available over a common data bus and the 
power of TurboDOS, they designed in a master 
processor to take care of the things that usually 
slow you down. And, up to sixteen POPPYs can 
be arranged in one System 4, working like one 
big bouquet of computing power. 


How do you use it? 


Our consultants can help you design the 
system that best fits your needs. The System 4 
can be a complete computer for a small com- 
pany or a departmental system. Or it can be a 
part of a distributed network for larger com- 
panies, providing multi-user access to data. If 
you have ordinary PCs that you want to link 
into a POPPY network, you can do so over a 
conventional serial LAN. 


If I pick it, will it be easy to use? 


Absolutely. If you already know PC-DOS, 
you're in the driver’s seat. And if you need 
assistance, applications have help screens that 
take you through the rough spots. TurboDOS, 
the operating system for the System 4, lets you 
use all the most popular programs that run on 
the IBM PC —so if you're already using pro- 
grams like Lotus 1-2-3, Wordstar, dBASE IlI+, 
and Flight Simulator, you won't have to 
transplant anything. You can merge data on 
your PC with information from POPPY. And all 
your users can share all the information. 

CP/M already in use? No problem. You can 
run CP/M 80, CP/ M86, and PC-DOS pro- 
grams at the same time under TurboDOS, with 
file and record locking. (So the data goes to the 
people you want sharing it and no one else.) 


Let’s plant the seed. 


Before you settle for just a garden variety 
computer, you're invited to pick POPPY. A com- 
puter with the power and flexibility to grow 
with you. Please contact one of our represen- 
tatives today by phone or fill out the coupon 
and mail it. Who knows? Our relationship may 
bloom into something big. 


Charter Information Corp 


Where good ideas improve. 


2421 Rutland 
Austin, Texas 78758 
(512) 835-111 
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Specifications: 
Workstation: 
Processor 
Clock Speed 
RAM 

Display 


Keyboard 
Port 


Modem 
SmartCable 


System 4 
Backplane 
Master processor 
Diskette 


Hard Disk 
Tape backup 


80188 

8MHz (no wait states) 
512K 

Monochrome, CGA, EGA, 
and Hercules 

Selectric style 

Serial port (IBM PC Com 1 
compatible) 

Integral 1200/2400 baud 
modem (optional) 

ll pair shielded (200' 


max.) 


IEEE 696 

ICM memory mapped 
720K or 320K (software 
controlled) 

20, 46, or 76 MB 
Stream out, media or file 
by file restore (optional) 


Max. Poppys/case Sixteen 


Name 


Max. Printers/case Sixteen 


You’ve planted a seed in my mind. 


Please send me more information 
on how I can use POPPY to 
cultivate productivity. 


Title 
Company 
Address 


City 


State 


Telephone 


Zip 


ee. 
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#1 Lint for MS-DOS 


4 MS. MS-DOS (Microsoft), Amiga (Commodore) ! 


CIMPEL SOFTWARE 


The professional 
diagnostic facility for C 


PC-lint lets you zap swarms of C 
bugs and glitches at a time. 

Now you can uncover the quirks, 
inconsistencies, and subtle errors 
that infest your C programs... 
waiting to bite you. PC-lint finds 
them all ... or as many as you 
want... in one pass. Set PC-lint 
to match your own style. 


Outperforms any lint at any price 


@ Full K&R support and 
common ANSI enhancements 
(even MS keywords) 

= Finds inconsistencies 
(especially in function calls 
across multiple modules!) 

= Modifiable library descriptions 
for 8 popular compilers 

= Super fast,one-pass operation 

= Suppress any error message 

& Zillions of options 

PRICE $139 > MC VISA* COD 

Includes USA shipping and handling. § 


ORDER TODAY, 
30-day guarantee 


Runs under MS-DOS 2.0 and up, and 


i; AmigaDOS. Uses all available memory. /f 


Trademarks. PC-lint (Gimpe! Software) 


3207 Hogarth Lane, 
Collegeville, PA 19426 


(215) 584-4261 = 


Se 


{procedures to be executed in protected mode should go here} 
beep; 
{test_screen;} 

port [$64] :=Sfe; 

inline ($f4); 
end; 


{return to real mode} 
{Halt to wait for reset to take effect.} 


begin {main routine} 

setup_idt; 

setup _gdt; 

save_segs; 

save_8259 regs; 

set_cmos for shutdown; 

setup_jump_locations; 

goto_protected_mode; 

{protected _mode_exitpoint will return to here.} 
end. 


BSW-—Make 


A practical and efficient 


software configuration manager 
for MS-DOS, VAX/VMS, and VM/CMS 


At The Boston Software Works, we routinely work with a number of different operating 
systems and development environments. One tool we have found to be indispensable is 
BSW-Make. BSW-Make is a complete implementation of the UNIX make utility. It automates 
the tedious task of rebuilding your software after an editing session; BSW-Make does only the 
minimum work required to update your program after a change, saving time and preventing 
missed compiles. 


We carefully constructed BSW-Make to be portable, and have used it successfully under MS- 
DOS, PC-DOS, VAX/VMS, and VM/CMS. We wouldn’t want to start a major software 
project without it, and we think you won't either, once you've tried it. 


Highlights of BSW-Make: 
Works with any compiler, assembler, linker, or text processor 
Not copy protected 


Indirect command file generation facility overcomes operating system command 
length limitations 


Macro facility for parameterized builds 
Syntax compatible with UNIX make 
30-day unconditional money-back guarantee 


MS-DOS 
$89.95 


BSW-Make for MS-DOS runs 
on any MS-DOS machine. It 
requires MS-DOS or PC- 
DOS version 2.00 or later, 
and is shipped on IBM PC 
5% inch diskettes. 


VAX/VMS 
$495.00 


BSW-Make for VAX/VMS 
runs on any VAX or 
MicroVAX running VMS 
version 4.0 or later. It is 
shipped on 9-track magtape 
or RX50 diskette. 


VM/CMS 
$550.00/yr 


(Available soon) BSW-Make 
for VM/CMS runs on any 
IBM 370-series, 43xx, 308x, 
or 309x system running 
VM/CMS. It is shipped on 
9-track magtape. 


All prices include shipping within the United States and Canada. Foreign orders (except 


Canada) add $10.00 handling; 


MasterCard or VISA, or company purchase order. 


actual shipping cost will be billed. 


The Boston Software Works, Inc. 


(617) 367-6846 
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120 Fulton Street, Boston, MA 02109 


We accept checks, 


Creating MYLIB in 
Modula- 


Lone nia ore ee 
A Modula-2 
Tutorial—Creating 
Library Modules 


Any language is only as good as the extent | 


to which it helps the programmer. Being 
inherently lazy, I needed a structured, 
self-documenting, powerful language that 
I could learn fast. As an ex-Pascal advo- 
cate, I can say that Modula-2 fits the bill. I 
don’t want to beat the drum about all of its 
power, but I do want to share with you one 
aspect that I have found outstanding. 

I don’t mind having to write a new pro- 
cedure, but I get bored when I have to re- 
write it time after time. In Modula-2, li- 
brary modules provide programmers with 
an external hierarchical structure. Pro- 
gram modules are at the highest level of 
the hierarchy and can import identifiers, 
from library modules. Library modules 
naturally export identifiers but they can 
also import identifiers from lower-level li- 
brary modules. 

It was obvious that once I wrote a good, 
debugged, working general procedure, all 
I had to do was save it in a library, and it 
would always be available for any pro- 
gram I might write. 

Thus, you now know what I want to 
share with you. I will show you how to 
create your own library called “MYLIB.” 
The process is simple, and the library you 
create can help you speed up your pro- 
gramming tremendously. 

Creating a library module requires the 
writing of two compilable units: a Defini- 
tion module and an Implementation mod- 
ule. Normally, these files have the same 
file name but different extensions: for ex- 
ample, MYLIB.DEF and MYLIB.IMP. 

The DEF or Definition module contains 
constant, type, and variable declarations 
and procedure headings. This is all the 
compiler has to know to check type consis- 
tency across compilation units. It is also 
the only information essential to any pro- 
grammer who wishes to make use of this 
module. The IMP or Implementation mod- 
ule contains the bodies of procedures and 
the statement part of the module. 
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The modules are hierarchical, so chang- 
ing definitions part means you have to re- 
compile all lower modules. When you 
change the implementation part of the 
modules, however, only that part has to be 
recompiled. That is what you would usu- 
ally be doing—modifying the body of your 
procedures rather than the headings. The 
result is that you rarely have to recompile 
a module because you have changed a 
lower one. 

Each library module, once successfully 
compiled, is composed of two components: 
a symbol file (MYLIB.SYM) and an object 
file (MYLIB.MCD). My particular com- 
piler uses M-code as an interim device for 
speed of development. Once ready to go, 
an option flag is flipped, and the program 
then compiles into a Z80 COM file. That is 
the reason for the type MCD: It is the M- 
code file type. 

Together the symbol and object files 
form a library module. The only thing you 
need to do when you want to use the proce- 
dures within the library module is to im- 
port them. For example: 


MODULE Example; 
FROM MyLib EXPORT Beep; 
VAR 


indentifiers; 
etc, etc 

The example program above shows that 
I only needed to ask the compiler to go to 
MYLIB and export the procedure BEEP. I 


could have said: 


FROM MyLib EXPORT Beep, AppendExt 
StripExt, GetExt; 


and the compiler would have gone to 
MYLIB and gotten all of those Procedures 
for me from MYLIB. So I have the option 
of getting one or more procedures from my 
personal library. I will go into depth later 
about those procedures and how to make 
them into a library module but I want to 
expand on some additional benefits of us- 
ing this type of a module approach to 
programming. 

An important capability provided 
through module usage is data abstraction. 
Data abstraction is accomplished by first 
declaring the type as an identifier in the 
Definition module, without describing the 


structure of the type—for example: 
TYPE AnIdentifier; 


and then placing the description of the 
type in the corresponding Implementation 
module. 


TYPE AnIdentifier = WHATEVER; 


This technique effectively hides the 
structural details of the type from users of 
the module. A type declared in this way is 
often referred to as a hidden type. Any 
user only needs to look at the Definition 
module for his programming information. 
The details of the procedures are hidden 
and are of no interest, because you only 
want to use them. You should try to put in 
extra comments in the Implementation 
module because, once it is written, you 
probably won’t see these commands again 
for long periods of time and will naturally 
forget why you did what you did. 

Back to our library: So that you can see 
the steps I took to develop the library, I 
will present them one at a time. First, I 
wrote the Definition module: 


DEFINITION MODULE MyLib; 


TYPE 

Extension = ARRAY [0..2] OF CHAR; 

FileName = ARRAY [0..12] OF CHAR; 

PROCEDURE AppendExt 
(VAR DiskFileName 
Ext : Extension); 

PROCEDURE StripExt 
(VAR DiskFileName : FileName); 

PROCEDURE GetExt (str : FileName; 
VAR Ext : Extension); 

PROCEDURE Beep; 

END MyLib. 


: FileName; 


Not much to it, is there? If I were to 
publish MYLIB, I would only have to ex- 
plain the Definition module, since what is 
in the Implementation module makes no 
difference to the user. There can be no 
conflict of identifiers, because the vari- 
ables are local and thus invisible to any 
procedure or module outside of that 
procedure. 

The Implementation module is a little 
more complex than the Definition module 
because it is actually a normal procedure 


or module written with comments or any- 
Continued on page 72 
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sie Fn B- Tree / ISAM 
File Handlers 


Have you ever been frustrated by the ca- 
pabilities or performance of a database- 
management package? Then why not use 
an off-the-shelf B—Tree/ISAM file han- 
dler to do the job? There are several such 
packages currently available that may suit 
your needs and surprise you with their ca- 
pabilities. Add a CRT screen handler pro- 
gram for input, a report-generator pro- 
gram for output, and some C code to glue 
them together, and you will have a a high 
performance, sophisticated database ad- 
ministration system tailored exactly to 
your needs. 

I tested three database file handler 
packages. Two of the packages were writ- 
ten in a neutral dialect of C. By this I 
mean that any C compiler which supports 
the C language as described in Kernighan 
and Ritchie’s book The C Programming 
Language would be able to compile these 
programs by making a few minor changes 
with some global definitions. The other 
package was supplied as an executable 
file. It makes itself resident; you invoke it 
by interfacing subroutines that permit you 
to call the program not only from C, but 
from a variety of languages such as BA- 
SIC, COBOL, Pascal, or FORTRAN. Actu- 
ally, you can use any language you desire 
for interfacing with this package by writ- 
ing a trivial subprogram. 


C-TREE 

The first package I tested, from FairCom, 
Inc., is called c-tree. This B—Tree/ISAM 
file handler subroutine package, written 
entirely in C, is supplied as source code. 
You can modify the source code to do any- 
thing you desire. The source code is 
straightforward and can be compiled with 
several C compilers. The documentation is 
excellent—easy to read and apply. 

Several weeks after the program ar- 
rived, I received some clearly written in- 
structions from FairCom that corrected 
some minor bugs and added some en- 
hancements to the package. 

To test the c-tree subroutines, I used c- 
tree to create and generate two files with a 
relational structure. A second test proce- 
dure read both files sequentially and then 
used an index key to perform a random 
record retrieval from one file, extract a 
key from that file, and update the other 
file. I encountered no bugs in this process. 
c-tree allows for fixed- and variable-length 
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records, and shared- and exclusive-use 
files on virtual or permanent devices. The 
keys can be segmented, unique, binary, or 
character, but they cannot be signed inte- 
gers. In other words, c-tree makes magni- 
tude comparisons. You can, however, use 
your own collating sequence, which, in a 
sense, lets you do your own comparisons. 
If these features are still not enough, you 
can rewrite anything you want, since you 
have the source code. 

In addition to these features, keys can 
be of variable lengths, and the key seg- 
ments can be located in variable-length 
fields of a variable-length record. To 
round out this impressive list of features, 
the keys can also be floating point, with 
trailing alphanumeric characters and, as 
noted above, you may define any collating 
sequence for key comparisons. 

c-tree supports networking by means of 
record locking. For those systems such as 
MS-DOS that support file locking by ex- 
clusive use only, dummy lock files are cre- 
ated to lock the region of the file in use. 

Naturally, when you use this package 
you must be able to read and understand 
the documentation. The manual was 
clearly written and well printed. A refer- 
ence card answers most questions once you 
are familiar with the product. A generous 
number of source code examples are also 
provided; they allow you to take a look at 
the way a certain function was employed, 
in case the written word wasn’t quite 
enough. A large portion of the manual is 
given over to improving the performance 
of c-tree, hints for use, compiling c-tree 
programs and the like. I rate the documen- 
tation A+. 

If you develop a package with Fair- 
Com’s c-tree, you may incorporate any 
part of the compiled code as a part of the 
program, subject to certain restrictions. 
You may then sell the composite binary 
program without payment of royalites to 
FairCom. The license agreement seems 
fair. At $395 for a single-user license, this 
program is a good product and reasonably 
priced. c-tree runs on several computers 
under different operating systems. It has 
also been ported from the iAPX 86/88 to 
the DEC VAX series, the Motorola 68000 
and 6809 series, National Semiconduc- 
tor’s 32032, the AT&T 3B2, and the IBM 
Series/1, all under different operating 
systems. 


BTRIEVE 

Next, I investigated SoftCraft’s Btrieve, 
another B—Tree/ISAM file handler that 
runs under MS-DOS. Unlike c-tree and the 
other B—Tree/ISAM file handlers I inves- 
tigated, Btrieve is supplied as a binary 
module (an .EXE file) that you must load 
into memory as if it were a program you 
were going to run by itself. 

It comes with an impressive manual 
that consists of lucid, well-presented ex- 
amples. It interfaces with many lan- 
guages. You communicate from your pro- 
gram to, and from, Btrieve by means of 
interrupts. Btrieve sets the interrupt vector 
to point into itself; every call to Btrieve 
becomes a software interrupt call. This al- 
lows a high degree of isolation between 
your program and the package. While 
there is admittedly some increased over- 
head on a software interrupt, the number 
of actual software interrupts executed is 
small when compared to the rest of the 
body of program instructions. 

Suppose SoftCraft were to change the 
features in Btrieve to improve their opera- 
tion? I think that it would be easier just to 
change the package as an alternative to 
recompiling or relinking the application 
programs out there that use Btrieve. Also, 
I hate waiting for the linker to do its thing. 
Keeping Btrieve out of the linking process 
speeds up development and makes overlay 
programming easier. The down side to this 
is that a newer version of Btrieve may 
cause your program to stop working even 
though you didn’t recompile it. This hap- 
pened, for instance, because a newer ver- 
sion 4.x uses “handle” I/O and the older 
version 3.x used basic I/O; some older pro- 
grams actually ran out of handles. 

Another recent enhancement, variable- 
length records, causes Btrieve to return 
the length of each record read. This could 
clobber the calling sequence of a program 
designed to run under the older version of 
Btrieve; where the record length was only 
an input to the interface subroutine. In 
these cases, it is best to stick with the old 
version of Btrieve until all the enhance- 
ments and their consequences are care- 
fully thought out. 

The interrupt-calling feature also al- 
lows any compiled program, or inter- 
preter, to call Btrieve with a simple sub- 
routine. SoftCraft gives you many 
examples of these subroutines. Btrieve 
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comes in a networking version (Btrieve/ 
N) that I did not test. I was assured by 
numerous Btrieve users that SoftCraft is 
helpful and courteous. 

In addition to supporting a variety of 
keys—segmented and nonsegmented, du- 
plicated and unique, binary and charac- 
ter—Btrieve allows the user to supply an 
“own code” collating table for each key. 


A powerful feature of Btrieve is transac- 
tion processing. You can mark any transac- 
tion on a file, or group of files, by means of 
two operations, “Begin transaction” and 
“End transaction.” You can use an op- 
tional “Abort transaction” code to exit 
from the transaction at any time. The files 
involved in a transaction are not updated 
until the transaction ends normally. As a 
practical example, suppose you were up- 
dating a file, or several files, and you deter- 
mined that for some reason the update had 
to be discontinued. You could simply abort 
the transaction, leaving all of the files in 
their original state without having to back- 
track and clean up the mess. This process 
has some overhead, but I used it extensively 
in a complicated program and saw no per- 
formance degradation. 

Btrieve performs well and is well docu- 
mented. It is the fastest B—Tree/ISAM 
handler I have used. I chose it for two 
applications over c-tree because I needed 
its transaction-processing features. It, un- 
like c-tree, is written in assembly lan- 
guage. Naturally, it can only be used to 
interface with MS-DOS and cannot be 
ported to other operating systems or pro- 
cessors. This is a distinct disadvantage if 
you are writing applications for different 
machines or operating systems. Neverthe- 
less, as with any program supplied in 
source-code form, you trade off some flex- 
ibility to the mercy of your C compiler, 
which may not produce highly optimized 
code, and which requires recompilation 
and relinking if changes are necessary. 

Like c-tree, Btrieve comes with a no- 
royalty distribution license for the incor- 
porated composite programs. SoftCraft 
requires that you register your program 
with it first. 


SOFTFOCUS B—Tree ISAM Handler 
The last product I evaluated was a collec- 
tion of three C subroutines from Soft- 
Focus. These subroutines fall into three 
catagories: ISAM file handlers, B—Tree 
handlers, and routines to handle variable- 
length records. Not nearly as complete as 
the previous products, these subroutines 
are supplied in source form with terse but 
complete documentation. Networking is 
not supported directly, but you could mod- 
ify the source code to do any kind of net- 
working you desired. 

I used this set of subroutines in the two- 
file relational database that I tested c-tree 
against. I found that both c-tree and Soft- 
Focus gave similar results. I did not test the 
variable-length features of either package. 

The manual gave an excellent introduc- 
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tion to B—Tree theory and ISAM files. 
Spending the few dollars for this sturdy, 
well-thought-out, although simple, pack- 
age is a good investment if you do not need 
the “heavy hitting” features of c-tree or 
Btrieve. 


IN SUMMARY 
These packages illustrate some of the 
products available for building a sophisti- 
cated database system. Before embarking 
on such a project, you should define your 
goals, the data, and the requirements. Pur- 
chase your software from a reliable source 
and try to get it on evaluation. If you have 
a serious application, you might need to 
buy several packages to evaluate their 
suitability for your needs. 

There is no neat program to tie the data- 


base file handler to the screen handler. Re- 
port generators that work with Btrieve and 
c-tree files are available, but I did not use 
or test these programs; rather, I wrote my 
own. All tests were performed on an Alloy 
PC+ System with a 640K IBM PC, an Al- 
loy 85Mb Drive and a 60Mb tape backup. 
NTNX, a proprietary Alloy Computer 
Products operating system, was used to 
operate two V-20 PC slaves and one 8088 
slave PC under MS-DOS 3.1. With three 
disk partitions, it was possible to test the 
simultaneous operation of three programs 
running in parallel on each slave card. 
Lattice. C, Version 3.1, and MASM 4.0 
were used for interfacing and compiling. § 


Andrew Bender, M. D., is a neurologist 
with 25 years programming experience. 
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any other interactive C development system. Much faster than traditional 
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ard to believe? Here's how we do it. 

Because Jnstant-C is a high-per- 
formance interpreter there are no com- 
pile or link delays, Change your program, 
then test it immediately. No matter how 
large your program, the turnaround time 
is just seconds. 


“Instant-C means instant gratification." —PC 
Magazine, Editor’s Choice for best C interpreter. 
10/29/85 

“Time after time, the Instant-C prompt was 
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PC Tech Journal, 5/86 


Source-level debugging saves your time. 
- set any number of conditional 
breakpoints in your program; 

- stop execution from keyboard; 

- single-step by source statement; 
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code, and continue execution; 
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directly for instant testing; 
_ - display source code back-traces; 

New!- source code animation; 
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devices. 
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than with any of the other products 

discussed.” — Computer Language, 2/86 


Immediate feedback and more than 400 
diagnostics makes /nstant-C great for 
learning C. Full K&R and the ability to New! 
link compiled object code and libraries 
(Lattice and Microsoft) makes Jnstant-C 


there's a better way you could learn C"— 
Programmer's Journal, 3/85 

“Clearly, Instant-C is the performance 
champion.’ —PC Tech Journal, 5/86 


The bottom line for your business is in- 

creased productivity. The result for you is 

a job well done, and quickly. 
“We sincerely feel that Instant-C can have a 
major positive impact on programmer 
productivity.” —Computer Language, 2/85 
“Instant-C by Rational Systems is aC 
programmer's dream.’ —.Micro/Systems Journal. 
3/86 


Version 2 is available for MS-DOS and 
PC-DOS, and comes with a full 31 day 


money back guarantee. /nstant-C is only 
$495. Order today! Call or write for full 


information. 
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Rational Natick, MA 01760 


Systems, Inc. (617) 653-6194 
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With C-terp you can edit, debug, and run 
without the wait. Nothing, but nothing, is faster 
for developing professional C programs. 


Choose the perfect C-terp companion 
for your C compiler 


C-terp/Microsoft C-terp/XENIX 
C-terp/Lattice C-terp/Aztec 
C-terp/Mark Williams C-terp/C86 


Link in all your compiler's functions, your own 

functions, add-on libraries, assembly routines, 
and data objects. Get instant access to every- 
thing in the C-terp interactive environment. 
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enhancements 
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30-day money-back 
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He uses computers in his private neurol- 
ogy practice and designs hardware and 
software for neurophysiological data ac- 
quisition and research. 


WHAT IS A B—Tree ISAM FILE? 

You need know nothing about B—Tree in- 
dexing, ISAM files, or database design to 
use the subroutines discussed in this arti- 
cle. A complete treatment of the subject is 
beyond the available space in this issue. If 
you are only interested in getting a small 
application running, do not worry about 
the theory of database indexing. If you are 
working on a large database with multiple 
related files, I suggest you read the Comer 
article and Wiederhold book (see Refer- 
ences). The way you organize your data 
will have important effects on the per- 
formance of different systems. 

The term B—Tree has a nebulous begin- 
ning, but probably it was called B—Tree 
after R. Bayer, or after Boeing Aircraft’s 
Scientific Research Lab, Bayer’s employer. 
Later, the nature of the tree led users to say 
the B was for “balanced” or “bushy.” A 
B—Tree index contains pairs. Each pair 
contains a key and a location in a file where 
the data associated with that key may be 
found. This organization scheme is similar 
to that of a book index in which you look up 
the topic you are interested in (the key) to 
find the page (the location of the associated 
information or data). 

The associated data is usually a record 
of related items, and the file of these asso- 
ciated records is a relational database. 
Therefore, you can use the index to locate 
records in a relational database. 

A certain number of pairs are located 
on the index page of the book, just as there 
are only a certain number of pairs on the 
index page of a B—Tree file. The maxi- 
mum number of possible pairs of index 
keys and locations on an index page is 
fixed and is two times the “order” of the 
B—Tree. A single pointer, on each page, 
without any associated key, is used to di- 
rect the B—Tree search to an index page 
that contains lower-value keys than are 
present on the current page. 

The locations in the B— Tree index may 
point to the actual data related to the in- 
dex key, or they may point to more index 
pages. An indicator is used to signal the 
search routine as to whether the target 
data is file data or another index page. The 
B—Tree file-organization method for in- 
serting and deleting records from the data 
file always leaves the B—Tree balanced, 
minimizing time required to search it. 

Different methods of organization of a 
B—Tree file are given different names. A 
B+ —Tree file contains a separate index 
file with pointers into a sequential file con- 
taining the actual keys. A B+*—Tree file’s 
index nodes are two-thirds full instead of 
one-half full. This is called a “bushy” tree 


by some. 

The records of a relational database are 
generally organized in an indexed sequen- 
tial scheme. The ISAM, or Indexed Se- 
quential Access Method, was first de- 
signed to relate physical storage addresses 
to data records in a large magnetic drum 
data-file. The ISAM file contains one pri- 
mary index made up of keys and pointers. 
The key’s pointer points to the record con- 
taining that key. This organization lends 
itself particularly well to the B+ —Tree 
searching method where the keys are in 
the data-file and the index file is separate. 
When the ISAM file is read sequentially, 
records are returned to the user in the or- 
der of the primary index. The index part of 
the ISAM file is physically part of the data 
part of the ISAM file. Secondary indices 
can also be defined in an ISAM file, so that 
when references are made to the file and a 
secondary index is selected, the records 
are returned in the order of the secondary 
index. Although the physical storage ad- 
dresses are not usually used to retrieve 
data records from a data file, the method 
is still known as ISAM, and it still is a use- 
ful method of organizing data in files that 
will not require later sorting. 
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To order Toll-Free 
call 1-800-367-0651 


61 


Intercepting 
XIOS Calls 


by Alex K.H. Soya 


Certain applications, under Concurrent 
CP/M (CCP/M), may need to intercept 
XIOS calls in order to reroute XIOS func- 
tions or to implement device-drivers for 
hardware not normally supported by the 
XIOS. The days of modifying your BIOS or 
XIOS device driver code, to perform the 
above, are unfortunately over. Few OEMs 
include the source code and object modules 
necessary to generate a new operating- 
system image with their systems software. 
If the device-driver source code is available 
to the end user, it is usually at a prohibitive 
cost. 

In this short article, I wish to propose a 
method to intercept XIOS calls. By inter- 
cepting XIOS calls it is possible to dynami- 
cally install device drivers or rerouting pro- 
cedures to perform what in the past could 
only be done by altering the XIOS. The 
method I use is generic to any CCP/M sys- 
tem and is thus not dependent on a particular 
implementation. 


A DIRTY TRICK 


Before going any further, let me say that 
I believe that intercepting XIOS calls, or 
even making calls to the XIOS directly, is 
an extremely bad habit. At all times pro- 
grammers should avoid playing with XIOS 
calls and only use such dirty tricks as a last 
resort. By making XIOS calls one cannot 
guarantee that the program will function 
correctly with another version of CCP/M, or 
even another manufacturer’s particular im- 
plementation. However, in certain situa- 
tions, there is just no other solution but to 
make calls to the XIOS, or even worse, 
intercept calls to the XIOS and perform or 
emulate XIOS functions in an application 
program. 

Now that I have expressed my feelings 
about intercepting calls to the XIOS, let me 
present my method: reroute a XIOS call to a 
handler in an application program and let 
that handler perform a particular XIOS 
function rather than the XIOS. 


NOT THIS WAY 

At first you may say easy: just obtain the 
current vector to the XIOS entry point in the 
SYSDAT page, save it, overlay the vector 
with a value pointing to a routine in the 
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Install Device 
Drivers or Special 
XIOS Function 
Handlers 
Dynamically 
Within Application 
Programs Under 
Concurrent CP/M 


application program, and it’s done. As soon 
as the application program has completed 
execution, restore the old vector and all is 
back to normal. 

Unfortunately several problems can 
occur using this obvious method. If the pro- 
gram runs more than once, or another pro- 
gram using the same method is executed, it 
will perform the same action. That is OK, 
until the original program terminates and 
restores the XIOS vector. Now the second 
program no longer intercepts the XIOS calls 
and thus will no longer function. Even more 
catastrophic things can happen. 

The problem of multiple programs inter- 
cepting XIOS calls is not the only one. 
Some OEM implementations of CCP/M 
make use of the XIOS ENTRY vector in the 
SYSDAT page to locate certain data struc- 
tures within the XIOS. A typical example 
would be the FORMAT program under 


Queue Start 
te 


S yyyy 


Figure 1. 


CompuPro’s CCP/M-3.1D. The FORMAT 
program obtains drive parameters from the 
XIOS depending on the type of disk 
selected. As the XIOS-ENTRY vector 
points to the handler in the application pro- 
gram, the FORMAT utility is unable to 
obtain the required structures. Another ex- 
ample would be the Gifford disk cache 
buffering program used for their RAM 
drives. Overlaying the XIOS ENTRY jump 
vector in this case causes the system to crash 
with *Wild Interrupt’ messages. 


MY METHOD 


I propose the following method be used 
for intercepting XIOS calls by application 
programs: create a queue for the sole pur- 
pose of managing a buffer for redirection 
vectors. As the buffer is in the same seg- 
ment as the XIOS code segment, the JMP 
address at XIOS ENTRY (0CO3h in SYS- 
DAT page) can be modified to jump to the 
buffer. In the buffer, a JMPF instruction 
would cause the XIOS call to be redirected 
to the application program. This avoids the 
problem of overlaying the XIOS vector in 
SYSDAT, and thus lets programs such as 
FORMAT perform correctly. In addition, 
each process that intercepts XIOS calls 
would be inserted into a doubly-linked list. 
When a process exits, it would delete its 
entry in the linked list and thus leave the 
other processes intercepting XIOS calls un- 
disturbed. The last process to terminate de- 
letes the queue from the system and restores 
the original JMP offset at the XIOS entry 
point. 

The above scheme will only work reli- 
ably if there is no chance of the process 
being aborted from an external program 
such as ABORT (or STOP under CCP/M 
4.1). Therefore the process must set itself to 
be non-abortable and every effort must be 
made to handle all possible errors from 


JMPF DWORD PTR yyyy| =‘ ToXios Seg:Off Prev Seg:Off Next Seg: Off 


Fields assigned to the queue buffer. 
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within the program. Before the process ter- 
minates, it will delete itself from the linked 
list. 


THE QUEUE STRUCTURE 


Figure | shows the fields assigned to the 
queue buffer. The buffer is located within 
the SYSDAT segment of CCP/M. Normally 
queues are used to exchange messages be- 
tween processes. In this case, the only rea- 
son for the queue is to obtain a portion of 
RAM located in the SYSDAT segment. As 
the JMP instruction at the XIOS entry point 
is an intra-segment jump, only locations 
within the same segment as the XIOS can be 
reached. Digital Research has not provided 
for any locations within the SYSDAT seg- 
ment to be used by application programs. 
As long as no process writes to the queue, 
this method is safe. 

Notice the JMPF instruction at the start 
of the queue buffer, it causes the XIOS call 
to be redirected to the address pointed to by 
the ToXios field. The fields PREV and 
NEXT in the queue buffer are the root poin- 
ters to similar structures in the application 
program’s code segment (see Figure 2). 
Each program which needs to intercept 
XIOS calls contains the same fields as the 
queue buffer. The TOXIOS field points to 
the next processes XIOS intercept routine. 
If the field is contained in the last, or only, 
process in the list, then TOXIOS points to 
the location which the JMP instruction at the 
XIOS entry point used to jump to. Thus, 
TOXIOS is the link from the XIOS entry 
point to the resident device drivers of CCP/ 
M. The PREV field points to a process pre- 
vious to the current process and can thus be 
used to backtrack the linked list when delet- 
ing a process from the XIOS intercept list. 
The PREV field in the queue buffer will 
always contain a null value as the queue 
buffer is the root of the list. As expected, the 
NEXT field points to the next process in the 
XIOS intercept list. The last process in the 
list has a null value in the NEXT field. 


PSEUDO CODE 


As the routines to perform the actual 
insertion and deletion from the linked list 
are rather complicated, I include the pseudo 
code listings I used to write the actual 
assembly language routines. Listing | 
shows how to insert a process into the XIOS 
intercept list. The first process to install 
itself must create the queue and locate the 
queue buffer in the SYSDAT segment. 
Also, the operand of the JMP instruction at 
the XIOS entry point must be modified to 
point to the queue buffer. As the 8086 does 
not use absolute addresses in the operand, 
the relative offset to the buffer must be com- 
puted. Note that all interrupts must be dis- 
abled while the pointers are modified to 
prevent any XIOS calls from being made 
during this procedure. If interrupts are not 
disabled, a XIOS call could be made while 
the pointers are only partially filled and thus 
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TOXIOS 
NEXT 


<3 Pointer to next Xios handler or XI0S 
<a Pointer to previous node 


<a Pointer to next node 


Figure 2. The node pointers in a process intercepting XIOS calls. 
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A second process inserted™in 


XIOSINTCPT routine 
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JMPF Dword Ptr ToXios 


XIOS entry point 
from JMP inst. 


XIOSINTCPT routine 


JMPF Dword Ptr ToXios 


XIOS entry point 
from JMP inst. 


Process 1 


XIOSINTCPT routine 


e 


JMPF Dword Ptr ToXios 


Figure 3. Pointers at XIOS intercept list nodes. 


cause catastrophic results. Listing 2 demon- 
strates how to delete a node from the list. 
Note how much simpler it is to delete an 
item from a linked list than it is to insert an 
item. Refer to Figure 3 for a graphic repre- 
sentation of the various pointers for single 
and multiple nodes in the list. 


THE REAL THING 


And now to the real thing. Listing 3 is 
the assembly language version of the above 
mentioned pseudo code. These routines 
should be included by your application pro- 
gram (if you use RASM86 you can just link 
the routines with your program).Note that 
the routine, XiosIntcpt, is your routine 
which performs the actual Xios emulation 
and is thus not shown in Listing 3. The 
current implementation requires that the 
process has a unique code segment if multi- 


ple copies of the same task are run. In the 
near future, I hope to modify the routines to 
allow shared code segments. Contact me if 
you require your program to use shared code 
segments. Any future versions of the 
routines in Listing 3 that I develop will be 
compatible with the present routines. 
Listing 4 presents an example program, 
named CONNECT, making use of XIOS 
intercept routines. The program is rather 
primitive and requires a lot of refinement 
before being used in critical applications. It 
is merely here to demonstrate how to use the 
intercept routines from an application. The 
purpose of CONNECT is to make a logical 
connection between two virtual consoles 
allowing the operator to monitor and control 
the activities on another terminal. The desti- 
nation console must be in dynamic mode or 


in the foreground for CONNECT to work 
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‘| Taming 
S-DOS 


for customizing the 
MS-DOS eavironment 
by Thom Hogan 


Learn how to make DOS work for YOU! Taming MS-DOS will take you beyond 
the basics, picking up where your DOS manual leaves off. This advanced users 
guide will show you how to extend the power of DOS so you can work more 
accurately and efficiently. 


® Learn to maximize your batch files with routines using redirection, fil- 
ters and pipes. You'll find routines that prevent accidental reformatting of 
your hard disk, redefine function keys and locate files within 
subdirectories. You'll learn to implement a DOS help system with help text 
files, a menu system that interprets keyboard input, and a routine for 
Taming quick redefinition of function keys. 
MS-DOS @ You'll learn how to customize CONFIG.SYS to maximize the perform- 
ance of your system and how to use ANSI.SYS to tailor your system 


Toots and techiques prompt and monitor attributes to fit your needs. 


for customizing the 
MS-DOS environment 

spac ® Taming MS-DOS includes nearly 50 ready-to-use programs that in- 
crease DOS's functionality. Now you can easily rename directories and 
disk volumes, change file attributes, check available RAM and disk mem- 
ory, display a memory-resident clock, and assign DOS commands to ALT 


keys. 


® Quick reference charts provide easy access to batch command syntax, 
CONFIG.SYS syntax and ANSISYS command strings. 


Taming MS-DOS shows you how to alter programs and customize DOS to fit 
YOUR needs, saving you time and frustration every time you use it! 


The programs, including batch files and DOS enhancements, are also available 
on disk along with full source code. 


Taming MS-DOS Item #060 $19.95 
Taming MS-DOS with disk Item #061 $34.95 


To order: return this coupon. 


Ma&T Publishing, 501 Galveston Dr., Redwood City, CA 94063 


Taming 


YES! | want to make DOS work for me. Please send me: 


MS-DOS —— copies of Taming MS-DOS at $19.95 each 
—— copies of Taming MS-DOS with disk at #34.95 per set 
Tools and techniques 
Subtotal 
for customizing the ; ; 6 
MS-DOS eaviroament CA residents add appropriate sales tax % 
Then ogee Add $1.75 per item for shipping 
TOTAL 
[-] Check enclosed 
Charge my L] VISA] M/C L] Amer. Exp. 
6 ry NE 
Signature 
Name 
Address 
a BY 3039 
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correctly.The routine, XIOSINTCPT, in 
Listing 4 is the XIOS function handler. It 
will intercept any console output calls for 
the console of interest and store them in a 
local circular queue. The call is then for- 
warded to the actual XIOS for output to the 
destination console. The CONNECT task 
continuously reads the circular queue and 
forwards any characters found to the local 
console. If a key on the local console is 
pressed the character will be sent to the 
Virtual Input queue (VINQ) for the target 
console. This example will work on any 
version of CCP/M. The only critical part is 
the flag number used. Make sure you set this 
flag to a value that does not conflict with 
your system’s implementation. 

CONNECT demonstrates how to re- 
route output from one console to another 
console. I have also used the above XIOS 
intercept routines to write a device driver for 
a special I/O board which was not supported 
by the XIOS as implemented by the manu- 
facturer of my system. 

I would suggest that you use the above 
routines anytime you need to intercept 
XIOS calls from an application program. I 
feel that this method is a relatively safe 
procedure and should work fine as long as 
all programs use this very same method. 
am still open to suggestions for any im- 
provements and would welcome such. The 
next step would be to develop a generic 
XIOSINTCPT routine allowing shared code 
segments to be used by application pro- 
grams. I have made these routines available 
on my Concurrent RCPM system at (305) 
727-0331 for your convenience. And as a 
final comment let me stress again that inter- 
cepting XIOS calls should be avoided if at 
all possible. (1) 


Alex Soya has been involved with CP/M 
for over 8 years. He is currently a computer 
science senior at Florida Institute of Tech- 
nology. His interests include Operating 
Systems, Data Communications, System 
Utilities, Real Time and Scientific Pro- 
gramming. 
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Listing 1 
Inserting a process into XIOS intercept list. 
Procedure Hook_in_xios list 


[ Insert Process into Xios intercept list ] 


Begin 
If XiosVect Queue does NOT exist then 

a ag 
Make Queue 
Disable Interrupts 
Locate XiosVect Queue buffer 
Que.Buffer Start := JMPF DS:DWORD Ptr (Buffer Start+4) 
ToXios SEG™ := XIOS SEGMENT ~ 
ToXios OFF := addr@ss([XIOS_SEG:ENTRY+1] ) 
XIOS _SEG:ENTRY+1 := displacement (Que.Start) 
Que.Prev := NILL 
Next := NILL 


else 


Begin 

Disable Interrupts 

Locate XiosVect Queue buffer 
ToXios := [Que.ToXios] 
[Que.Next].Prev := ToXios 

— Next := [Que.Next] 


Que.ToXIos := XiosIntcpt 
Que.Next := ToXios 
Prev := Que.ToXios 
restore interrupt state 
end 
Listing 2 

Deleting a process from the XIOS intercept list. 

Procedure UnHook_From Xios List 


[ Delete Process from Xios intercept list ] 


Begin 
Disable Interrupts 
Prev.ToXios := [ToXios] 
Prev.Next := [Next] 
If (Next = NILL) and ([Prev].Prev = NILL) then 
in 
Restore XIOS entry JMP address 
Restore Interrupts 
Delete Que 
end ~— 
else 
If ( [Next] <> NLL) then 
in 
[Next] .Prev := [Prev] 
end 
Restore Interrupts 
end 


Listing 3 


;XINICPT.A86 - Xios Intercept Routines 


8-20-85 Initial Version. 


Alex K.II, Soya 


se se se se 


;This set of routines allows process to insert & remove itself from 
zlinked list structure allowing an application program to intercept 
;Xios calls & emulate such in a local routine. Also allows special 
zdevice drivers to be installed in a.dynamic manner. 


;Following routines allow multiple such processes to insert & delete 
;themselves from list without interfering with each other. 


; 
;As method of intercepting XIOS calls is very sensitve to changes, 


ycausing incompatibility between programs if not handled in uniform 
manner author publishes these routines under following conditions: 


;Routines should also work with MPM-86, but were only tested under 
Concurrent CPM 3.1 and Concurrent PC-DOS 4.1. 


‘ 


ie 


——-—-—COPYRIGSH?— —_—-— -— 

3 

#Following routines are COPYRIGHT (C) 1985 by Alex K.H. Soya 

; 

7All commercial rights to these routines remain with author unless 
agreed differently in WRITING by author. 
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#You may use these routines in public domain application programs 
zafter notifying author of intentions to do so. If your program 
zis for commercial purposes (rather than lic domain) you will 
qrequire author's consent in writing before selling programs 
zusing these routines. 


i 
sAbove is so that author may be able to notify you in case of any 
ychanges. A lot of planing and work has gone into method used to 
+to intercept XIOS calls. 
3 Alex K.H. Soya 

Campuserve [70406,1452] 

Concurrent RCPM GOLIATH (305) 727-0331 


: 

; 

, 

; P.O. Box 510121 

; Melbourne Beach, FL 32951 
; U.S.A. 

; 

+ Voice Phone (305) 724-9921 
ry 

i 

iz 


mr 


ou can put these in your program head eh ye other equates 
£ you use this as an INCLUDE file under 6 
CWRITESTR equ 9 #Write string to console 


Q MAKE equ 134 7Make a System Queue 

Q-OPEN equ 135 ;Open a system queue 
equ 136 Delete a Queue 

S SYSDAT equ 154 ;Return SYSDAT address 

False equ 0 

true equ not false 

RASM86 equ true ;Set to TRUE if using RASM 86 


zand declare following public 
zlabels as external in your code segment 
If RASM86 


public Hook In Xios List 
public 


public ToXios Off ~ zyour XINICPT routine uses 


plink into xIOS intercept list 
From Xios List;delete fran xios intercept dase 
= s 


zvector to forward calls to xI0S 


public XIOS 
ur application 
IOS by a CALLF 
you need to call xios directl: 
This is a 
function 


rogram & call 


extrn XiosIntcpt:near 


andler. Its 


to next node in list and-thus 
actual xios, 


we Se St se we we we we te se 


ENDIF 


a 


locate_XiosVect_Que_ Buffer 
Entry -> bx = offset SYSDAT page 
es = segment SYSDAT page 


Return <- Bx = offset of XiosVect Queue buffer 
es = Segment of XiosVect Queue buffer 
ax = 0 = found buffer 
ax <> 0 = Buffer not found 


we we we se se we we we we we we 


ee we se se se Se ne we se te 


i 
QLR equ 74h + Queue List Root 
locate x iosVect. Que Buf; fer: 


add bx int to Root of QUEUE list 
Search For buf: oe 


™ MoV bx,es: [bx] 7 Get next Queue D offset 
amp bx,0 
jnz got one mre + I£ queue not found then 
or al,0Ffh ~ ? notify caller 
ret } return 
got one more: 

— “nov ¢i,bx 1 get Qname offset 
add 4!,6 
nov si, offset XQWAM ; prepace for conparison 
mov cx,8 7 8 racters in name 
cld 3 incrementing comparison 
trepe ampsb 
jne search For Buf 7 until ue found 
mov bx, es:26[Dx] 7 get Buffer offset 
aoe ax ,ax ; fer was found 
re 


Hook in Xios List 
= ™ Overlay XIOS jump vector to point toa 
redirection vector in a Queue Buffer. 
Initialize the redirection vector in the 
gue to contain address of a local xios 
unction intercept handler. 


we Se se se ne se te se 
SO Se sa se se se se se 


i to make code more readable: 
es:Word Ptr DI 


Que“ToXios“Seg equ es:Word Ptr 2{di 
Que“Prev_ OFf equ es:Word Ptr 4{st 
Querrey "Seq equ es:Word Ptr 6[di 
Que Next Of equ es:Word Ptr 8[di 
Que Next Seq equ es:Word Ptr 10[di 
P TOxios Of equ es:Word Ptr ea 
PToxXios equ es:Word Ptr 2[di 
FP Prev Off equ es:Word Ptr 4[di 

evs equ es:Word Ptr 6[di] 
PNext0f equ es:Word Ptr 8[di] 
PNext7Seg equ es:Word Ptr 10[di] 


Hook_In Xios List: 
Gx, offset XIOSQPB 

mov cl, Q OPEN 

int 224 — 

or = ax,ax 

jnz Make Que 

eue al: i 

Make Que? ™ queu€é_already exists 


mov dx, offset XIOSQQD ;make queue 
+ Q_MAKE 


3 try to open XIOS intercept 
? queue 


3 I£ queue NOT exist then 


rif make NOT success then 
mov dx, offset BAD XQ MAKE es 


mov cl, C WRITESTR™ ~ ;tell operator 


int 224 — 
or al,0ffh yand return error code and 
ret ;return to caller 

xios_q made: 


mov dx, offset XIOSQPB 


mov cl, Q OPEN 
int 224 — 


Open Queue so we can delete it 
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declare this as extrn XIOS:DWORD in 
Os instruction if 


lication programs Yos 
uld handle 
function you want to intercept and 
do JMPF DWORD PTR ToXios Off to get 


mov cl,S SYSDAT 
oad = 
aii 


sobtain SYSDAT segment 
+disable interrupts 


push ax 
call locate XiosVect_Que Buffer;Locate Xios Vect Que buffer 


Or ax,ax 
Pp ax 
Le Que Buffer located 


Que_Buffer not_Tocated? 


PO) 
mov dx, offset No Buffer 


mov cl,C WriteStr~ 

int 224 ~ 

mov dx, offset XIOSQPB 
mov cl, Q DELETE 

int 224 ~ 

or ax,0ffh 


ret 
Que_Buffer_ located: 


Queue_alzesdy exists: 


mov es: [bx] ,2effh 
mov dx,bx | add dx,4 
mov es:2[bx]} ,dx 

mov di,bx 

mov bx,ax 

add bx, 28h 

mov dx,es:2[bx] 

moy ToXios ax 


mov dx,es:1[bx] 
dx,bx ! add dx,3 

mov ToXios Off,dx 

mov ax,di ~ 

sub ax,bx | sub ax,3 

mov ge? [bx] 7ax 


’ 

mov Que Prev Off,0 

mov Que Prev Seg,0 

mov next_off,0 

mov next7seg,0 
common insert 


mov cI,S SYSDAT 
int 224 — 
pushf ! cli 


zIf Queue buffer not found then 


srestore interrupt state 
;send error message 


7Delete Queue just in case 


7Set Error Fl 
7return to caller 


sQue.Start := JMPF DWORD PIR 
+ (Que. Start+4) 


3Get SYSDAT Offset 

ipoint to XIOS entry vector 

7Get Xios Segment 

7ToXios SEG := XIOS SEG 

7Get XIUS ENTRY offset 

7Get JMP displacement 

7make address 

7ToXios OFF:=add((XIOS SEG:ENTRY+1]) 
7get address of Que.Start 

;campute displacement 

;XIOS SEG: ENTRY+1 := Disp(Que.Start) 
Point to Que.ToXios 

;Que.Prev := NILL 


7Next := NILL 


relse (XiosVect Que exists) 


tlocate Sysdat page 
7Clear interrupts 


call locate XiosVect_Que Buffer ;Locate Queue Buffer 


Or ax,ax 


jnz buffer not located 


mov di,Bx | add di74 
mov dx,Que ToXios Off 
mov ToXios Off ,dx— 
mov dx ,Que“Toxios Seg 
mov ToXios~Seg,dx~ 


es 
mov dx,di 


les di,Dword Ptr Que Next Off 


7if Buffer not found, abort 
7point to Que.ToXios 
;ToXios := [Que.ToXios) 


+ [Que.Next] .Prev := ToXios 


mov P Prev Off, offset ToXios Off 


mv P Prev Seg, CS 
mov di,dx ~ ' 
pop es 
dx Next Off 
nett Ora 
que Next 
next. Ség,dx- 
rt: 


Next := [Que.Next] 


3 end 


mov Que ToXios Off,offset XiosIntcpt 


mov QueToXios Seg ,CS 


+ Que.ToXios := XiosIntcpt 


mov Que Next OFf, Offset ToXios OFF 


mov Que Next™seg, CS 
mov prev off;di 
mov prev—seg,es 


f 
bali locate_real_xios 


“; Que.Next := ToXios 
} prev :* que.Toxios 


Restore Interrupts 

zkeep address of real XIOS, for 
;those who need to call XIOS 
;functions directly. 

;No error 

send 


jous in order given 


This current version oes NOT allow your process to run 


XOr ax,ax 

ret 
3 The following must be conti: 
;NOTE* 
sues SS 

0: 

Prev Off te ° 
Prev 
Next=oft aw 0 
Next Seg aw 0 
xIOSs~ rd 2 


UnHook From Xios List 
Removes process from Xios Intercept list 


Entry -> None 
Return <- None 


UnHook_From Xios List: 


sh£ ! Cli 


as SHARED / OOS: af execute more than once. 


3 Pointer to next intercept 
3 or real XIOS 

3 Previous node 

3 Next Node 


3 vector to actual xios entry 


Se Se 0 se a0 ne 0 


; Disable Interupts 


es di, Dword Ptr prev Off 


mov dx, Toxios Off 
mov P ToXios OFf,dx 
mov dx, Toxids 
mov P ToXios Seg, 
moy ax, Next Off 
mov P Next Off,ax 
mov dX, gh 
mov P Next ,ax 
orc ax,dx ~ 

or ax, P Prev Off 
or ax, P Prey Seg 
or ax, dX 
jnz Not Last item 
mov ax,ToXios Off 
mov bx,28h ~ 


ELETE 
mov dx, Offset XIOSQPB 


f 
int 224 
ret 


Not_Last_item: 


Tov ax,Next Off 


or ax,Next Seg 
2 Not Last Node 
es 


+ Prev.ToXios := [ToXios] 


; Prev.Next := [Next] 


3 If ({Next)=Nill) 
jand ([Prev).Prev = Nill) then 
sRestore XIOS entry JMP address 


make displacement 
yand restore XIOS ENTRY JMP disp. 


;Restore interrupts 
Delete queve 


else 
If (({Next)<> NILL) then 


oes 


di,Dword-Ptr Next_Off 


mov dx.Prev Off 


; [Next] .Prev:=[Prev] 
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Popft 3 Restore Interrupts 


locate ae ~This routine will locate the actual xI0s 
in the cou and store a vector pointing there 
coun e word XIOS, An application 
‘am may then make calls to the XIOS 
be} it intercepting it own calls. 


Entry -> ToXios established 
Return <- XIOS filled in with vector to actual XI0S 


ee 


St Se we Se we we we we we we te 


locate | real_xios: 


mov di,offset ToXios Off 
mov ax,cs | mov es,ax 
f ft cli 3 make sure nobody moves us 


While Not Nill: 
3 While [Next] <> Nill do 


+ point to our node 


mOv ax,P Next off 
or ax,P Next Seg 
fe found terfiinal Node 


es di,Dword Ptr P-Next Off 3 Point to next node 


While Not > NilT 7 endWhile 
found_term nodé: 
les di;dword P ToXios 3 Off 


mov Word Ptr xI0S,ai 


1 XIOS := [ToXios] 
mov Word Ptr XI0S+#2,es 


popf 
ret + end proc loacte 1 real _xios 
? Té you use ASHG6 and have not yet defined DSEG 
+ offset. Bo your ORG here 
XIOSQPB of 3 The Queue Parameter Block 
dw cetoet dum buf 
Xonan & rrr taal 
OSQQD ’ De! 
db *kiosVect" achidatasitieia aa 
dw af 
dw 18 
= nheeal aia tail 
a 
+++ Unable to n XiosVect Queue ++','$' 
No Buffer Msg db '+++ Could not Tecate XiosVect Queue buffer ++! °'$! 


+ Tiow its“time for a beer. 


LISTING 4 


Connect current Virtual console to another virtual 
console. For Concurrent CPM only. 


sCNCTI1.A86 = 


CONNECT Vers 1.1 - moni tles to make use of XINICPT routines 
08/20/85 to assemble with RASM86 
Racanes to fit in Compuserve Directories 
To Assemble: SET CPCDOS4] te to whatever you have 
abd then as: e as: 


RASM86 CNCT11 $PZSZ 
LINK86 CONNECT=CNCT11,XINICPT 


After executing type a Ctrl-Z to get out 
of CONNECT 


Original Version : 
Author : Alex Soya 


Compuserve [70406,1452] 
Concurrent RCPM Goliath (305) 727-0331 Sa bps 
P.O. Box 510121, Melbourne Beach, FL, 3295. 


| Sueeeeneseos: 


- Nov. 1984 


eee ee 


false t) 
true on not false 
CPcDos41 equ FALSE }; True if for Concurrent PCDOS 4.1 
3 else for Concurrent CPM 3.1 
3CCPM function calls 
P TERNCEM equ 0 ;Terminate & release all resources 
C"READ equ 1 ;Read character from Default Console 
C WRITE equ 2 7Write character to Default Console 
CRAWIO equ 6 ;Direct Console I/O with Default Console 
CWRITESTR equ 9 #Print ASCII string to default console 
equ ll Obtain Status of Default Console 
DEV WAITFLAG equ 132 wWait for c System Flag 
equ 133 7Set system Flag 
Q OPEN equ 135 ;Open A system queue 
Q WRITE equ 139 7Write message to System Queue 
S"“SYSDAT equ 154 Return address of System Data Segment 
a equ 33° ;Return address of process descriptor 
di equ 
lf equ 10 
entrl Z equ '2'-40h 
ON equ Command line Option can be found here. 
BASEFLAG equ 80 ;BaseFlag + console # used ag i 
3YOU MAY NEED TO CHANGE THIS 
;NUMBER TO ONE NOT USED BY “bes 
QDEPTH equ 40 3# of bytes in output Circular oie i 


3 Sysdat Offsets: 

+ 

H 

SUPENTR equ Oh rvisor entry offset 
XIOSSYS — equ 28h : Offset to Xios vector 


extrn Hook_In_Xios_List:near #Xios intercept list handler 
extrn UnHook From Xios List:near;routines 


extrn ToXios Off:"Word~ ;Pointer structure 

public xiosinEcpt 3The actual intercept routine 
“Bush ! pop bx #No interrupts during stack switches 
mov ax,ds 


ax,ds 
8s8,ax 
sp, offset stack 


cat teceee, DS 


mov 
mov 
push bx 1 
mov 
call 
call 
jz 
mov dx, offset invmsg 
mov cl, C WRITESTR 
int 224 a 

gexit 
mov TOON, al 
mov Word Ptr VONAM, dx 
mov dx, offset VINQPB 
mov cl, Q OPEN 
int 
canp 
jz 
mov 
mov 
int 
Jmps 
mov 
int 
mov 
mov 
mov 
call 
or 
jnz 


RB 
io 
Ba 
ai 

a 

H 


ror message. 


7_ and terminate 

7Save the Target console # 

;Make proper Queue name 

yopen VINQ que for target console 


224 ~ 
pola } If Not Open then 
ae offset no H Write an error message 
cl, C WRI 
224 
gexit : and terminate 
jendif£ 
qopnd: 1,8. SieDee 3Get Supervisor Segment [1.1] 
3 
ax,es:2[bx ; {i i} 
cs:SUPVSRt2,ax ; (1.1 
cs:SYSDAT,es 
nook sin xio8.1 List rInsert in Xios intercept list fil 
ax ; ° 
gexit ; if failure, get out 1:1) 
mainloop: 
call tread re at main 1 
jz cloc (target = read? then 
call tget ; get target character 
call lput 3  enBiE character to local console 
clocal: call lready 
jz mainloop ; if (local = ready) then 
call Iget 3; get local character 
onp sentrl 2 3 check for abort 
jz exit — 3 if abort then exit 
call tput , put character to target console 
3 mainloop zuntil abort 
exit: call Unllook, Fi From Xios List }; Delete from intercept list [1. 1) 
gexit: call makeus 3 make us a‘user process again 
mov cl,P TERMCPM 3 and terminate us 
int 224 ~ 
DSKEEP dw 2 
7 
makesys: Set current process as a tems process in PD flag ; 
field a and set KEEP flag to to’ keep process fram being ; 
; 
? 3 
? Entry -> None ? 
; Return <~ none : 
; Regs used: ax, bx, cx, es : 
i H 
hake 3 
= mov cl,P_PDADR } Obtain process descriptor address 
ao a= + bx offset (PD); es := t (PD) 
mov = 
or esiword ptr 6[bx],3 7 PD.PLAG i PD.FIAG or SYSTEN+KEEP 
ret yend makesys ; 
; makeus: Reset the system and keep attribute in PD flag : 
’ 
; En > None ’ 
, pera <- None : 
H i 
hakeus: ed Si roe 3 Obtain PD address 
mov bx, ax bx:= offset (PD); es:= fim ere 
and es:Word Ptr 6 {bx} »not 3 ; mask PD.FLAG. 
ret 
agtarg Get console number as option from command tail , 
. entry -> none ; 
: Return <- re = 2 byte byte ASCII value from buffer ( 0 - 99) ; 
= Integer 0 - 
: FLAG = f valid a Nz if Invalid option! 
' 
3 Regs used : AX,DX,CX 
H ; 
deargs cmp Byte Ptr .OPTION,' ' ;If£ No Tail then No Option 
je nooption 7else 
mov dx, word ptr .OPTION 3 DX := Option 
mov ax,’ 7 AX :™= Option (in Ascii) 
sub al,'0' ; Convert AX to binary in AL 
comp ah,'0' . 
jb no tens 3 If second digit then 
oanp ah;'9' 
ja no_tens ? adjust 
sub ah;'0' 
mov ch,ah 
mov cl,10 
mul cl 3 make first digit the tens 
add al,ch 7 AL = binary (DX) 
eo ‘ al,0 ; og it in x 
3; is on in 
o option 3 Mops; 9o.no option found 
camp al,99 
jg neoption 
if ae icad F 
np 
nz not single 
Pea gh.r0' 
dl dh 
not_single: 
xor ah,ah 3 set flag 
‘i ret 
noopt. Ons 
or ah, 0£fh 
ret 
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—————— 
3 tready: See if a character from the target console ia ready, tay 
; is a character in the circular gqueve buffer 


Entry -> nothing 


] 

4 

: Return <- Flag = NZ if char is ready, Z if not 
, AL = FFh if char is ready, 0 if not 
3 
? 
? 
3 


ST ne me we se we we ee 


tready: mov si, offset OUIQUE + Here is our Que 
erat gempt 
Shz treadr 3 If Writer waiting then 
onp BFULL, Of fh 
jne treadr 
mov BFULL, 0h 7Set Flag to indicate que empty 
mov dl, BASEFLAG icompute Plag for this conso. 
add dl, TCON and set it. 
mov cl, DEV_SETFLAG 
int = 

treadr: ff 


3 ee ne 
3 tget: Get target character, i.e. Take it out of Queue buffer 


Entry -> None 
Return <- AL = Character 


Regs used: AX, SI, BX 


me se se ne se we 
we me se se we me te we 


; 
tget: mov si, offset OUIQUE 3 This is the Buffer 
call qdel 3 Go get the ir 
ret 
; 7 
3 lput: Send a character to local console , 
, ' 
, Entry -> AL = Character ' 
? Return <~ none 3 
] ; 
' Regs used: AX, CX, DX , 
+ 7 
{puts mov dl,al 3 Character to send to DL 
etd cl, C WRITE ; Use System C Write function 
it 47 a 
ret 
lready: Obtain status of local console 


Entry —> none 
Return <- AL = Olh if Char ready, 00h if not ready 
Flag = Z if not ready, NZ if ready 


Regs used: AX, BX, CX 


Jone we se me S080 80 86 mene 
re rere 


ready: Led gc STAT 3 Use System C_stat function 
t 224 — 

or al,al 3 Set Return Flag 

ret 
; 7 
3 Iget: Get a character from the local console ; 
; ; 
7 Entry -> None ' 
2 Return <- AL = character , 
3 ; 
3 r) 
iget: mov cl,C RAWIO 

mov 1,0%dh 

int 224 

ret 


tput: Send character to target console. Does this by writing 
character to the target consoles VINOn System Queug. 


Entry -> AL = Character to send 
Return <~ AX = AX on entry. 


06 wa te Se Se Be Ne te Se 
ee me se te we te ne 


g 


mov 70 ;Null High Byte 

mov Word Ptr Qbuf,AX put character into Queve buffer 
mov dx, offset VINOQPB ;DX := Queue Parameter Block offset 
mov cl WRITE 

int 

Fet 


Q 
224 ~ zand send a message 


xiosintcpt: Intercept call to XI0S & handle IO CONOUT function} 
for target console locally. 


Entry -> AL = XIOS function number 
oe = Character to send 
= Virtual console to send to 


Return <- Jumps to XIOS with all registers preserved 
Except Flag, which is not used by xIOS 
functions. 


Pr 
St se me Se ne me we se se 


ds 
ds, DSKEEP 


cmp al 
3 dom 
jne jxios 


7Get this Data Segment 
zit XI0S function=2 (Console Output) 


and 
Console = Target Console 


see see 


then 
Insert char in queue 


call insert 
jxios: pep is 
jmpt cs:Dword Ptr Toxios ( Off ; Goto realxios or next process 


ene ER — SUNS SSRIS dP 
qinsert: Insert Scorsese ec SnbO, que If Que is full, wait until ; 
Same 5 Uses System Plags to wait for; 
empty a, + 


Entry -> CL = Character 
Return <- none 


se Se se we se se 


Regs used; All Registers preserved except flag Reg 
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HIGH PERFORMANCE RAM. 


Compupro 
Ram 22 


Octagon 
256K 


Cromenco 


256KZ I 


Dynamic 
Boards 


BG-Bank 
2568 


GUARANTEED IN YOUR SYSTEM 


CROMIX-D e MPM e CCS e OASIS e AMOS 


Vv PLUS: 8/16 BIT TRANSFERS e 24-BIT EX. ADDRESSING 
8-12 MHZ @ 2K DESELECTS e RAM-EPROM MIX 
IEEE 696/S-100 e LOW POWER e FULLY STATIC 


LITHIUM BATTERY BACKUP avoids power failure crashes intel- 
ligently. Unique POWER-FAIL-SENSE circuit allows processor 
to save register information and disable board before POWER 
FAILURE CRASHES memory. 


BG BANK 256S $695 
BG BANK 64S 


Battery Backup 
$299 Battery Backup 


BG COMPUTER APPLICATIONS, 206 Brookside, 
Bryan, Texas 77801 International orders add 30%. 


(409) 775-5009 


69 


ginsert: 
3 Save'm 


BEEEE 
PRRQZS 


pus! 
push = bp 
mov si, offset OUTQUE 7Get Circular a“ offset 
call full 3If is full then 
jnz nsrt 3 Wait for empty queve flag 
push si 
push cx 
mov bi te Ptr BFULL,Offh ; Tell Reader to set Flag when empty 
mov 7 BASEFLAG 3 Compute flag for this console 
add dal, Byte Ptr TOON + flag :™ BaseFlag + cols t 
mov cl, DEV WAITFIAG 7 lets wait for flag 
call upif ~ } direct supervisor cal 
pop cx 
pop si } end if 

insrt: mov al,cl } Character to send in al 
call queins 3 insert Character into que 
bop ak 
Pop si 
pop dx 
pop cx 
pop bx : restore them 
pop ax 
ret 


; gempt: Check to see if Que is empty 
entry -> si = que offset 


; 
; 

3} return -> Que orpty: al = 0, 2 is Set 

3 rc in que: al = FF, Z not set 
? 


; 
zlets not destroy anything other than al 


gempt: push bx 


mov bx, word ptr btsi] 3 get rear of que 

cmp word ptr[si],bx ; if front = rear then 

ra al, 0 

e qstat ; que := empty 

mov al, Of£fh 7 else que;= not t 
gstat: pop bx a ur 

or al,al 

ret 


? 

7 qfull: test if que is full. 

3 

3 entry -> si = que offset 

, 

3 return —> NZ = ok, Z = que FULL 
3 


3 


Se se Se se se we se oe 


3 

qfull: mov bx,word ptr[si)} 3} if front + 1 = rear then 
call inegptr ;)©6 que=full 
anp bx,word ptr 2[si) 
ret 3; 2 = full, NZ = ok 


———————————— 
3 incgptr: Increment the Que pointer. Takes care of wrap arround; 
; if end of que area is reached 

3 entry -> BX = pointer 
3 return -> BX = pointer + 1 increment 3 


st se se se 


incaptr inc ; point to next que offset 
amp = ind 7 end of que area reached ? 
jne 2 7 if not ue are done 
xor x ? ap... lets wraj 

pr ret a a 7 


a osciies insert a character into que. If que is full character 


? 

: is just droped. ; 
7 ? 
; entry -> al = character 3 
i si = que offset ; 
; : 
} return —> none : 
queins: push ax : 

call aad 3 find out if qe ts full 

pop 3 2 -> ok, NZ -> 

je 3 if que full pis —m data 

mov ag word tH fe 3 else que[front] =item 

mov byte pre {si+bx] ,al 

call ; front = front + 1 

mov wor eee laa) bx 
qind: ret 


qdel: delete a character fram que 
entry -> si = que offset 


me we se se se se se 
ne se we se we me te 


sh 


return -> al = character 
yanything in the 


lel: call asta que ? 
je 7no, 60 nothing we can get out. 
mov ape ptr 2[si) zal = que[rear 


mov al byte ptr 4[si+bx) 

call incgptr 7} rear = rear+l 

mov word ptr 2[si],bx 
@deld: ret 
i ? 
} supif: Call CCP/M Supervisor ; 
i , 
3 Entry -> CX = System call number ’ 
3 DX = Parameter ; 
? ES = User Data Area ; 
3 H 
; Return -> AX = BX = Return i 
’ CX = Exror Code ; 
Fy ES = UDA Segment (as on Entry) , 
' ; 
3 Regs Used: DX, SI, DI, BP are NOT preserved.. ; 
3 ; 
‘ 7 
, 
supif a ch,0 ; Clear High byte of function number 

es 

push ds 

mov ds, sdat 

mov si,.68h 

mov es,ds:l0h[si] 3 Get UDA of current process 

callf cs:dword ptr SUPVSR 

pop ds 

pop es 
70 


ret 
SYSDAT dw 0 3 SYSDAT segment 
SUPVSR dw 3 3 Entry to supervisor, offset = 3 
dw 0 7 Segment filled in later 
DSEG 
TCON db 0 } Target Console N 
BFULL db 0 3 Flag indicating buffer is full 
OQUIQUE dw i) 3 front of que 
oy 0 ; rear of Fe 
rs 3 here is the area, 
INVMSG db Pehvalia Virtual console jhmber.' * cr, lf 
db usage: CONNECT nn',cr,1 
db ' pn = Virtual Console eli scr,lf,'$' 
NOPMSG db * Unable to oe Tapat Queve.',cr,lf,'$' 
VINQPB dw VINQnn Parameter Block 
a offset Qbuf ‘i 
‘VI Primar ue name 
f not CPCDOS 41 , oe 
Hab 3 Secondary Queue name (Console number) 
If CPCDOS41 
db ‘o' 

VONAM db "3 

endif 
QBUF 40h * 2 zcan have 40 messages times 2 bytes each 
stack dw 0 


RTC p.us 


TRANSLATE RATFOR T0C... 
... PLUS FORTRAN ro C! 


@ VERY COMPLETE TRANSLATIONS OF 
RATFOR. Over 95% of STUG’s RATFOR is 
supported! 


@ NOW TRANSLATE FORTRAN-IV TO C! 
RTC Plus will now translate your FORTRAN-IV 
code to C (excluding I/O and F77 character). 
Tap vast FORTRAN libraries and accelerate 
your C development efforts! 


@ DEMO [S NOW AVAILABLE containing re- 
stricted versions of the RTC Plus package. 


@ NOW TRANSLATE TWO LANGUAGES FOR 
THE PRICE OF ONE! 


DEMO: $10 
MSDOS: $325 


COBALT BLUE 


1683 MILROY, SUITE 101 
SAN JOSE, CA 95124 
(408) 723-0474 
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Hardware Review 


The DRC Terminal Kit 


by Tony Dean 


In the world of supermicros, minis, main- 
frames, and many single-board comput- 
ers, ASCII terminals are the most com- 
monly used primary I/O devices. These 
terminals range in function from Spartan 
to luxurious and in price from a few hun- 
dred to a few thousand dollars. So when 
it’s time to select a terminal, how do you 
choose? 

If your needs are like mine and you need 
a terminal that is fast, flexible, reliable, 
and if possible, inexpensive, there are few 
serious alternatives. I chose to build my 
own using a terminal-board kit—Digital 
Research Computers (DRC) ZRT-80— 
and a separate keyboard and monitor. The 
terminal took me two weekends to assem- 
ble and cost about $350. Recent price cuts 
would drop this figure to less than $200. 
The DRC terminal board currently sells 
for $89.95. The source code for the termi- 
nal’s ROM is also available, on 8-inch disk, 
for $10. 

The ZRT-80 controls the video display, 
keyboard input, and I/O between it and a 
computer or modem. It uses a Z80-A mi- 
croprocessor for control, a 6845 CRT con- 
troller, and an 8250-baud generator/ 
USART. Its capabilities are impressive, al- 
lowing serious hackers to reconfigure the 
terminal. It offers four terminal-emula- 
tion modes—Heath/Zenith H-19, ADM 
3A, ADDS Regency 200, and Beehive. I 
use the H-19 mode with 24 X 80 
display format as it is reputed to be the 
most flexible. You can obtain higher dis- 
play densities by adding more RAM (posi- 
tions for an extra 6K are provided). The 
baud rate is selectable in 16 steps from 75 
to 19,200 baud. 

To build a complete terminal, in addi- 
tion to the ZRT-80 kit, you need a power 
supply, CRT monitor, and keyboard. You 
can select these items to fit your specific 
needs. Several surplus-component suppli- 
ers, as well as DRC, sell these items. Power 
supplies start at less than $20. CRT moni- 
tors range from $29.95 to $150. Heathkit 
has a monitor in kit form for $79.95 that 
looks nice. 

The ZRT-80 accepts an ASCII 7-bit par- 
allel input from the keyboard plus it has a 
toggle that allows you to change the nu- 
meric group into a function-key set like 
the Heath H-19. Keyboards range from 
$19.95 to $150. 

The board comes with a 21-page manual 
that contains complete information on con- 
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Assembling A 
Terminal From 
Components For 
Under $200 


struction, theory of operation, and setup. 
The ZRT-80 has five connectors—video, 
power, keyboard, option switch, and RS- 
232 interface. Both split- and composite- 
video output are provided. The power con- 
nector has LED and beeper outputs and a 
connection for an external reset switch. The 
option connector allows you to connect the 
DIP-switch assignments to an external 
switch set. The board has three eight- 
switch DIP assemblies that you can set to 
control the terminal’s default baud rate, 
emulation mode, and_ keyboard 
parameters. 

The manual covers basic operation to 
get the terminal through initial power-up 
and testing for proper use. The terminal- 
interfacing section is acceptable if you 
need only the basic configuration of pins 1, 
2, 3, and 7 with software protocol, but if 
you want to use any other RS-232 con- 
figuration, it might be a good idea to get a 
copy of RS-232 Made Easy and an RS- 
232 breakout box. The manual gives brief 
descriptions of display and emulation 
modes, and its final page contains a table 
of escape- and control-code functions for 
terminal mode. 

I found the ZRT-80 easy to assemble. 
The silk-screening is well done and easy to 
read, so assembly is a simple pick, place, 
and solder routine. All ICs are socketed. 
The only problem I had was having to re- 
place a damaged socket. Rather than wait 
for DRC to send a replacement, I bought 
one—and enough sockets to fill the extra 
RAM positions—from a local electronics 
store. 

Once you have completed the board as- 
sembly, you wire the ZRT-80 for power. 
When you apply power, the red LED 
should light to indicate proper function. 
Next you install the keyboard and CRT. 
When you reach this stage, you can power 
up the terminal system and run through 


the internal tests to see whether the termi- 
nal can display characters and read the 
keyboard properly. When you have set all 
the switches, made any connections, and 
run the tests, it is time to use the terminal 
with your computer. In my case, the ZRT- 
80 powered right up and worked fine on 
the first try—an edifying experience in- 
deed. I found that most software offered 
support for the H-19 display format. 

When everything is working well, you 
can explore such possibilities as expanding 
the ZRT-80 to support other keyboard ca- 
pabilities. Analysis of the source code indi- 
cates that the addition of support for the 
eighth bit, which lets you use arrow keys 
and a variety of special-function, word 
processing keys, is easy. The big question 
is what to do with the 12 function keys 
(they shift to give you 24 functions in all). 
Sockets are available for another 2732 
EPROM and 6K RAM, which gives several 
possible options. 

With this much potential, I feel my 
ZRT-80 can easily support the rest of the 
functions of the 8-bit ASCII keyboard to 
which it is attached. This conversion will 
require modification of the source code to 
allow the interpretation of the alternate 
keypad to be handled differently. With the 
modifications I plan, my ZRT-80 will be 
able to convert custom key inputs to es- 
cape sequences on some keys. Other keys 
will pass new codes or full 8-bit codes as 
would be needed by the function keys. 

The ZRT-80 has proven to be flexible, 
reliable, and expandable, and its standard 
features have seen more than a year of 
trouble-free use on my computer. The 
standard features alone exceed those of 
terminals costing hundreds more. For 
hackers who feel that standards are often 
substandard, the ZRT-80 allows them to 
customize a terminal to fit their individual 
needs precisely, and a fully customized 
terminal cannot be purchased off the shelf 
at any price. 


PRODUCT INFORMATION 


ZRT-80 CRT Terminal 
$89.95—Complete kit with 2K video 
RAM 

$49.95—Blank printed-circuit board with 
2732 monitor and 2716 character ROMs 
$10—CP/M source disk (8-inch) 
$7.50—Set of two crystals 

Continued on page 72 


71 


72 


SERVO INDUSTRIAL PROCESS CONTROL BOARD 


14 Bit Lab Accuracy 
Industrial Durability 


The Features of 5 Boards in One. 


we | reer 
Ve tly Wa Wd 
| zeae bt pe 


: scsicye Heres sa 
ae ape 


ta 


The Servo Process Control Board is a general purpose multi-channel 
analog and digital input/output controller which can communicate with 
and control most medium-scale industrial processes. Designed to work 
with the Servo Industrial Microcomputer, (or other computers which 
support the SASI interface), it offers great accuracy at prices starting 
as low as $495. 


B American made @ MILSPEC components @ 1 year warranty 
Maximum configuration includes: M 192 analog inputs § 64 analog 
outputs © 128 digital inputs 512 digital outputs 


@ Based on the INTERSIL 14 Bit A to Dconverter BCommunicates with 
any micro or mainframe computer & Easily programmed in high level 
languages (Turbo Pascal, Microsoft Basic, Forth) @ PID, FFT, Thermo- 
couple linearization and laboratory DAS software supplied @ Custom 
software and hardware engineering assistance available. 


360-B N. Ellensburg St 
& E Fe’ CR 
Gold Beach. OR. 97444 


SERVO COMPUTER CORPORATION (503) 247-2021 


C CODE FOR THE PC 


source code, of course 


a 
GraphiC 3.0 hi-res color plots . $300 
Panache C Program Generator . $125 
QC88 C Compiler. ...... . $90 
Concurrent C...... $45 
Coder’s Prolog inC ..... . $45 
Biggerstaff’s System Tools . . . $40 
Translate RulestoC .. » « « $80 
TGHEXS. st ao os, Mee te ee Sh . $25 
YACC & PREP ....... . $25 
tiny-c interpreter & shell. . . . $20 
OTe «ee tae se 8a 3 . $15 


eee 


The Austin Code Works 
11100 Leafwood Lane 
Austin, Texas 78750-8409 
(512) 258-0785 


Free shipping on prepaid orders No credit 


Creating MYLIB 
Continued from page 57 


thing else that will clarify the procedures 
function. The Implementation module is 
shown in Listing 1. 

The first thing you want to notice is that 
this Implementation module imported 
some procedures from another library. In 
this case, the library was furnished by the 
compiler’s library and was located on my 
disk drive. So if I wrote a sample program 
for you, I would import MYLIB, and 
MYLIB would import the systems library 
called STRINGS. That would be a four- 
layer hierachy. Even if I had used dupli- 
cate variables, it wouldn’t have made any 
difference, because they are all invisible to 
each other. 

There are excellent reasons to learn var- 
ious languages, and, in this case, some of 
those reasons have nothing to do with any- 
thing except programmer comfort. Creat- 
ing such a library as I have described pro- 
vides three major benefits. 


1. It reduces program compilation time by 
dividing large programs into smaller, 
separately compiled pieces. 

2. It creates well-defined boundaries for 
dividing work between programmers. 

3. It can be shared by different programs. 


| like to think of it as not reinventing the 
wheel. If you will share your libraries with 
me, | will share mine with you. § 


DRC Article 
Continued from page 71 


Digital Research Computers (of Texas) 
Box 381450 

Duncanville, TX 75138 

(214) 225-2309 
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MYLIB Code ~~ ustmcl 


IMPLEMENTATION MODULE MyLib; 

(* NOTE: I have removed the error trapping code to keep it 
simple, but it is needed since ‘Strings’ is 
sensitive to erronous lengths trying to fit into 
other things *) 


FROM Strings IMPORT Length, Pos, Append, Copy, Delete; 


(AA AAA RA eee RA Reem ewe Library Stuff HANH AAA RRA AR RRA AAR RRR REE) 


PROCEDURE AppendExt (VAR DiskFileName : FileName; Ext 
(" this will append a “." 


: Extension); 
and a extension if included *) 


VAR 
LengthCount : CARDINAL; 
BEGIN 
LengthCount := Length (DiskFileName) ; 
(* DiskFileName is a array so find the end and 
insert a period *) 
DiskFileName[LengthCount] := "."; 
(* now add the extension *) 
Append (Ext, DiskFileName) 
END 


aEND AppendExt; 


PROCEDURE StripExt (VAR DiskFileName : FileName); 
(* this will strip the period and the following characters *) 


VAR 

WherePeriod : CARDINAL; 

BEGIN 

WherePeriod := Pos(“.", DiskFileName) ; 


Delete(DiskFileName, WherePeriod, Length (DiskFileName) -WherePeriod) 


END StripExt; 


PROCEDURE GetExt (DiskFileName : FileName; VAR Ext : Extension); 
(* this will return the extension in Ext *) 


VAR 


WherePeriod, ExtLength : CARDINAL; 


BEGIN 
WherePeriod := Pos(".",DiskFileName) ; 
(* HIGH will find the array length *) 
Ext Length := HIGH (DiskFileName) - WherePeriod; 
Copy (DiskFileName, WherePeriod + 1, ExtLength, Ext) 


END GetExt; 

PROCEDURE Beep; 

{* this will cause the terminal to BEEP *) 
BEGIN 


WRITE (CHR (07H) ) = 
END Beep; 


END MyLib. 


LISTING 2 
The following can be used to prove the programs. 
MODULE ExtTest; 


FROM Strings IMPORT Length, Pos, Append, Copy, Delete; 


TYPE 
Extension = ARRAY [0..2] OF CHAR; 
FileName = ARRAY [(0..12] OF CHAR; 
VAR 


Example : FileName; 
Ext : Extension; 


PROCEDURE AppendExt (VAR DiskFileName : FileName; Ext : Extension); 


VAR 

LengthCount : CARDINAL; 

BEGIN 
LengthCount := Length(DiskFileName) ; 
DiskFileName(LengthCount] := “."; 
Append (Ext, DiskFileName) 

END 


END AppendExt; 


PROCEDURE StripExt (VAR DiskFileName : FileName) ; 


VAR 
WherePeriod : CARDINAL; 
BEGIN 
WherePeriod := Pos(".", DiskFileName); 
Delete(DiskFileName, WherePeriod, Length (DiskFileName) -WherePeriod) 
END StripExt; 


PROCEDURE Get Ext (DiskFileName : FileName; VAR Ext : Extension); 
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VAR 


WherePeriod, CARDINAL; 


ExtLength : 


BEGIN 
WherePeriod := Pos(".“,DiskFileName) ; 

ExtLength t= HIGH(DiskFileName) - WherePeriod; 
Copy (DiskFileName, WherePeriod + 1, ExtLength, Ext) 


END GetExt; 


(*2eeesseuessscaeescuanscoe= MAIN ss0neeensseenceneeneseeeeeent) 


BEGIN 
Example := '1234567'; 
WRITELN ("You should get “1234567", you got = ',Example); 
WRITELN; 
AppendExt (Example, ‘abc'); 
WRITELN ("Here you should get “1234567.abc, you got = ',Example); 
WRITELN; 
Example := '1234567.123'; 
Get Ext (Example, Ext); 
WRITELN('The extension should be "123", Its = *,Ext); 
StripExt (Example) ; 
WRITELN;WRITELN('The extension should be deleted, its = ',Example); 


END ExtTest, 


What if each change 
you made to your | 
program was ready to 
test in seconds instead 
of minutes? 


“The SLR tools will change the 
way you write code. I don’t use 
anything else.” , Joe Wright 


RELOCATING MACRO ASSEMBLERS ® Z80 ¢ 8085 ¢ HD64180 
© Generates COM, Intel HEX, Microsoft REL, or SLR REL 
@ Intel macro facility 
© All M80 pseudo ops 
© Multiple assemblies via command line or indirect command file 
e Alternate user number search 
¢ ZCPR3 and CP/M Plus error flag support, CP/M 2.2 submit 
abort 
© Over 30 user configurable options 
© Descriptive error messages 
e XREF and Symbol tables 
© 16 significant characters on labels (even externals) 


¢ Time and Date in listing 
e Nested conditionals and incLUDE files  $4OQS 
requires Z80 CP/M compatible systems with at least 32K TPA 


___§$ LR_Systems 


1622 N. Main St., Butler, PA 16001 
(412) 282-0864 (800) 833-3061 
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Software Review 


Running CP/M Under 
S-DOS: Part 2 


by Robert J. Stek, Ph.D. 


In a previous article (Converting from CP/ 
M to MS-DOS on the PC) I reviewed two 
Z80 coprocessor boards that enable users 
to run CP/M programs under MS-DOS. At 
the time of that printing, the only low-cost 
alternative to these boards was a public- 
domain CP/M software emulator. Unfor- 
tunately, that emulator gave a perform- 
ance equivalent to that of an 8080 CPU 
running with an under-1-MHz clock 
speed. 

Since then, however, the NEC V-20 and 
V-30 CPUs have become widely available 
as pin-for-pin replacements for the Intel 
8088 and 8086 processors. Besides provid- 
ing a small performance increase for IBM- 
compatible micros, they also have the 
unique property of being dual-mode pro- 
cessors in that they can directly execute 
the 8080 instruction set as well as the 8088 
instruction set at whatever clock speed the 
host microcomputer normally uses. While 
this does not provide performance quite as 
good as that offered by the 8-MHz Z80H 
used in the Earth Computers coprocessor 
board, nonetheless, it is more than accept- 
able for running the occasional CP/M pro- 
gram. Two distinct advantages that the V- 
20 enjoys over the coprocessor approach 
are: (1) you do not give up an expansion 
slot, and (2) the V-20 costs less than $20. 
Just as a coprocessor board requires some 
additional software to run CP/M pro- 
grams, so does the V-20. The price of this 
software ranges from free (public domain) 
to nearly $200. 

This article reviews two commercial 
products that use the V-20 to run CP/M 
programs under MS-DOS: CP/Mulator 
by Source Information, and PC RP/M2 by 
Micro Methods, Inc. Some cautionary 
notes about some potential problems with 
the V-20 are given first. 


99% & 95/100% COMPATIBLE 

I own a two speed “Turbo” clone machine. 
It can run at the standard 4.77-MHz clock 
rate of the IBM PC or at a moderately 
higher 6.66-MHz clock rate. I had hoped 
that between its Turbo mode and the im- 
proved performance of the V-20 over the 
8088, I would have the equivalent of a 7- 
plus-MHz PC. After all, everyone knows 
that the V-20 is an exact replacement for 
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Two Programs 
That Allow 
Running CP/M 
Programs On a PC 
or PC-Compatible 
Equipped With A 
V20 Chip 


the 8088, and that there would be no prob- 
lem substituting the new CPU for the old 
wae Al 

Because my machine does use a dual- 
clock speed, I was required to purchase the 
8-MHz version of the V-20 rather than the 
standard 5-MHz part. The faster part was 
a few dollars more, but I figured better 
safe than sorry. NEC rates the duty cycle 
of the V-20 somewhat differently than you 
might expect, and you should not take the 
chance that the S-MHz version will “prob- 
ably” work at a higher clock speed—it 
won't. 

My first task was to make sure that the 
V-20 worked as well as the 8088 it was 
replacing. | swapped CPU chips in less 
than five minutes; after all, the V-20 can 
only be installed in the socket two ways. 
And only one way is the right way! (Micro 
Methods assumes that you have already 
replaced the chip; Source Information 
does provide two pages of handholding in- 
structions in case you don’t know one end 
of a chip from the other.) 

I booted up PC-DOS 3.1 with no prob- 
lem. The screen cleared, and I received the 
normal date and time prompts. So far, ev- 
erything looked fine. I next wanted to run 
Norton’s SYSINFO program to compare 
the speed of the V-20 to that of the 8088. I 
put a disk in drive B and typed DIR, ex- 
pecting to see a normal directory display. 


The disk drive whirred and file names ap- 
peared on my screen in a normal fash- 
ion—until the display reached the bottom 
line, at which point you would expect the 
top line to scroll off the screen. Instead, 
the display (indeed, the entire machine) 
just stopped and hung there. Even pressing 
CTRL-ALT-DEL did nothing. It was neces- 
sary to turn off the computer and try 
again—with the exact same results. 

Additional investigating started to pro- 
vide some clues as to what was going on. 
Programs that never actually scrolled 
seemed to work fine. When booting up PC 
RP/M2 (more about this later, but in one 
mode, RP/M2 can boot up as a stand-alone 
CP/M replacement, bypassing MS-DOS 
completely), the same phenomenon oc- 
curred. It booted fine, but it would not 
scroll past the bottom line. I sometimes 
use FANSI-Console, a shareware-type de- 
vice drive that replaces the BIOS screen- 
writing routines for significantly faster 
screen updating. When FANSI-Console 
was loaded, everything was back to nor- 
mal; screen scrolling worked just fine. A 
final clue (or perhaps a bit of misdirec- 
tion) was that scrolling also worked fine if 
the machine was first put into its Turbo 
mode. That is, it worked fine with a 6.66- 
MHz clock but not with a 4.77-MHz 
clock—quite the opposite of what you 
might expect, since higher clock speeds 
have been known to cause problems. 

My first thought was to blame the NEC 
chip itself. I did have access to two other 
V-20s, so I tried them. Same results! I 
called the two vendors mentioned above, 
thinking that they might have had reports 
of similar problems. Neither had ever 
heard of such a thing. I spoke with a repre- 
sentative of NEC concerning rumors that 
there were two versions of the V-20: a cur- 
rent version that was OK and an earlier 
version that was not. He denied the ru- 
mors but did come up with a possible ex- 
planation of my problem. Much of the V- 
20's increased performance was due to the 
fact that it performed many of its instruc- 
tions in fewer clock cycles than the 8088. 
He suggested that perhaps my clone’s 
ROM BIOS depended upon some critical 
timing for the scrolling routine. 

That made some sense. When FANSI- 
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Console was in place, it completely by- 
passed the ROM BIOS routines and did the 
screen handling itself. And when the clock 
was changed to a higher speed, that 
changed the timing as well, and the two 
changes managed to compensate for each 
other in some unfathomable fashion. A 
call to the Arizona vendor of my clone re- 
vealed that he had heard from one of his 
dealers who had problems with V-20’s as 
well. To make a long story a bit shorter, he 
sent me a different ROM BIOS that solved 
the problem. 

The moral of the story is, nothing is ever 
as simple as it promises to be. If you have 
an IBM PC, you won’t have this trouble at 
all. But if you do not have an alternate 
version of a well-written ROM BIOS avail- 
able for your compatible, you may run 
into problems. 


TRANSFERRING CP/M PROGRAMS TO 
YOUR PC 

In my previous article, I mentioned the 
problem of transferring your CP/M pro- 
grams to MS-DOS format. Thank good- 
ness MS-DOS has not had the multiplicity 
of formats that plague the CP/M world. 
Perhaps the Uniform utility program is 
best known as being provided in versions 
for both CP/M and MS-DOS which allows 
you to read and write almost all of these 
different formats (from MicroSolutions, 
125 South Fourth St., Dekalb, IL 60115). 
You will need such a utility to use with 
CP/Mulator, but PC RP/M2 has a utility 
that allows it to read and write more than 
ninety CP/M formats. If you do not have 
such a utility, or if your unique CP/M for- 
mat is not supported, then you can still 
transfer programs via a serial link. Both 
CP/Mulator and PC RP/M2 provide a copy 
of a public-domain MODEM-type pro- 
gram to help the transfer along (assuming 
that you have a compatible program on 
the other machine). 

Whether you use Uniform or the PC 
RP/M2 utility, you will be able to place a 
CP/M formatted soft-sectored disk (e.g., a 
Kaypro disk) into one of the floppy drives 
on your PC and then transfer files over to 
an MS-DOS-formatted disk. This could be 
another floppy or a hard disk; preferably, 
it would be into a separate subdirectory so 
that you wouldn’t confuse any CP/M 
.COM files with MS-DOS .COM files. 
Overlay files, configuration files, data 
files, etc., are all transferred if needed. 


RUNNING CP/M PROGRAMS 

CP /Mulator 

CP/Mulator suggests that you change the 
file extension of all CP/M .COM files to 
-CPM in order to prevent inadvertent exe- 
cution of a CP/M command file under MS- 
DOS. It does allow for the odd CP/M 
application program that might require 
files with an extension of .CPM. In this 
case, the extension of the CP/M command 
files is not changed, and CP/Mulator is 
run with a command-line option. 
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CP/Mulator is supplied as a standard 
MS-DOS .EXE file (CPM.EXE). The emu- 
lator is present only when a CP/M applica- 
tion program is executing. Thus, you do 
not see a CP/M front end with the built-in 
CP/M commands (ERA, DIR, REN, SAVE, 
TYPE, USER); you would normally use the 
MS-DOS equivalent commands. MS-DOS 
cannot perform a CP/M SAVE, but CP/ 
Mulator does have a command-line option 
that duplicates the CP/M SAVE com- 
mand. This allows a SAVE of the CP/M 
TPA and any modifications made therein. 
In normal usage, CP/Mulator expects the 
name of the CP/M program (with its argu- 
ments, if any) as its argument—e.g., CPM 
SC2 to run SuperCalc2, or CPM MBASIC 
MYPROG to run the MBASIC program 
MYPROG.BAS. 

CP/Mulator also has one other com- 
mand-line option itself—a DEBUG option 
that allows for the display or capture of 
selected information during execution of 
the CP/M program. Debug information 
may be directed to the screen, a file or 
both. Its options are set through a bit mask 
as follows: 


80—debug active at program start 
40—debug output to file (DEBUG.LST) 
20—debug screen output disabled 
10—snap current DMA on emulator exit 
08—reserved for future option 
04—snap CP/M FCB in and out 
02—snap regs in and out of emulator 
01—snap BDOS function codes (nn) and 
BIOS entry numbers (:nn) 


Unfortunately, Source Information pro- 
vides absolutely no additional information 
or examples of the DEBUG option beyond 
listing the above options (the entire man- 
ual is just 30 pages long). 

During operation of the CP/M applica- 
tion program under CP/Mulator, two “hot 
keys” are always active—F9 and F10. Ac- 
tually, they could be called “warm keys,” 
since an outstanding read to the console 
may delay recognition of these keys until 
the next keystroke or a RETURN is keyed. 
F9 is the Menu key that causes a short 
menu to pop up on-screen as in Sidekick. 
Here you may enable or disable the debug 
options selected on the command line, save 
the TPA to a file, execute an 8080 RST 7 
instruction upon resuming the CP/M 
application (intended for use with an 8080 
debugger such as DDT), exit immediately 
to MS-DOS (without closing any open CP/ 
M files), or continue execution of the CP/ 
M application. F10 is the Abort key that 
terminates the emulator and exits to DOS 
immediately. 

Source Information notes that some 
CP/M commands are not supported or are 
only partially supported under CP/ 
Mulator. Partially supported are programs 
such as PIP and STAT that work except 
when referring to USER areas or the I/O 
byte. Not supported are some hardware- 
dependent programs such as MOVCPM 


and SYSGEN, and SUBMIT and XSUB. 
Also not supported are programs that give 
system hardware direct access to read/ 
write hardware port addresses (e.g., com- 
munication programs); programs that di- 
rectly access the CP/M diskette format, 
such as programs that format CP/M 
diskettes; and programs that use Z80 in- 
structions. These are reasonable limita- 
tions, since most of these programs are not 
used appropriately under MS-DOS in any 
case. 

Most BDOS and BIOS functions of CP/ 
M 2.2 are fully supported by CP/Mulator. 
Exceptions include: 


BDOS(3) _ [reader input] 
Waits for and reads a charac- 
ter from AUX (COM1) and 
returns. 

BDOS(4) _ [punch output] 
Outputs character from reg- 
ister E to AUX (COM1) and 
returns. 

BDOS(7) [get I/O byte] 
Value of I/O byte set by 
BDOS(8) is returned in accu- 
mulator. Not used by CP/ 
Mulator 

BDOS(8) [set I/O byte] 
Value of I/O byte is set to 
value in register E. Not used, 
but retained for 
compatibility. 

BDOS(10) [read console buffer] 
Similar to CP/M equivalent, 
but editing of line buffer fol- 
lows MS-DOS editing rules 
which only affects operator 
entry of data. 

BDOS(30) _ [set file attributes] 
Not supported. Accumulator 
always contains a zero upon 
return, 

BDOS(32) [get/set user code] 
User areas are not supported. 

BDOS(40) [write random with zero fill] 
Performs a write random 
(BDOS(34)) instead. 

BOOT Returns control to MS-DOS. 

WBOOT Returns control to MS-DOS. 

PUNCH Returns with no action. 

READER Always returns a hex 1A, 
EOF. 

HOME Returns with no action. 

SETTRK Returns with no action. 

SETSEC Returns with no action. 

READ Not supported, returns with 
an error. 

WRITE Not supported, returns with 
an error. 

SECTRAN Not supported, returns with 
an error. 


When running commercial programs, 
these differences actually make no differ- 
ence. I have tried several dozen applica- 
tion programs and utilities and have had 
no problems. 

Speed of execution was about what you 
would expect with a 4.77-MHz clock—a 
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tad faster than when the same program 
was running on a stock 4-MHz Z80 sys- 
tem. The expected 40 percent speed in- 
crease was noted when I ran my PC clone 
in its 6.66-MHz “Turbo” mode. (My 8- 
MHz Z80H Earth Computer coprocessor 
board ran them faster still, but it also cost 
several hundred dollars more!) 


PC RP/M2 

PC RP/M2, from Micro Methods, is 
unique among the dozen or so CP/M emu- 
lators for MS-DOS V-20 systems. It is a 
truly stand-alone CP/M 2.2 replacement. 
That is, you can boot up RP/M2 from the 
supplied floppy, bypassing MS-DOS com- 
pletely. All BDOS and BIOS calls are avail- 
able, since you are running a complete CP/ 
M-replacement operating system. Since 
PC RP/M2 occupies a little over one 64K 
memory segment, any remaining memory 
in the PC is automatically configured as a 
memory disk called ““M:” when RP/M2 is 
booted up. In a full 640K PC, this yields a 
memory disk of over SOOK! 

It is also possible, however, to boot MS- 
DOS first and then use the supplied MS- 
DOS program RPMSYS.COM to bring up 
RP/M2 under MS-DOS. This allows PC 
RP/M2 to have read/write access to all 
DOS files on all DOS drives through the 
supplied utilities RPMPIP.COM_ or 
PCPIP.COM, which allow file transfers 
from MS-DOS to RP/M2 and back. This is 
quite different from CP/Mulator, which 
essentially runs a CP/M application pro- 
gram as a task under the native MS-DOS 
operating system. With RP/M2 and MS- 
DOS coresident, you have two independent 
operating systems available, each with its 
unique disk format. If you wish to run an 
MS-DOS program, you must “leave” the 
RP/M2 operating system with a GODOS 
command (though you can call a memory- 
resident program like SideKick from 
within RP/M2). Similarly, to return to RP/ 
M2 from MS-DOS, you must use the 
RPMSYS command. Note that if you do 
leave RP/M2 to return to MS-DOS, you 
will lose whatever is stored on the M: drive 
memory disk if you return to RP/M2. 

RP/M2is a complete, CP/M-compatible 
replacement operating system, so it is sup- 
plied with more complete documentation 
(129 pages of it) than CP/Mulator as well 
as a number of utility programs. These 
utility programs duplicate and extend the 
capabilities of their CP/M counterparts. 
Other utilities include programs to set 
foreground, background, and border col- 
ors for color monitors; a program to emu- 
late some common display terminals for 
clearing the screen, positioning the cursor, 
etc.; an enhanced version of a SUBMIT fa- 
cility; a DUMP program; an unerase util- 
ity; a disk-test program to find bad blocks 
on floppies; a MODEM7 protocol file- 
transfer utility; and a program to redefine 
one of the floppy drives to use one of more 
than ninety other CP/M disk formats. All 
these programs have the .COM extension. 
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RP/M2 was created in 1982 as a “better” 
CP/M. It has access to user area 0 for all 
user areas, a paged TYPE command, a hard 
disk vector that keeps nondismountable 
disks logged in, batch procedures on any 
drive, a disk-addressing range of 64Mb, 
hash-coded vectored directory access, and 
file date and time stamping like CP/M 3.0. 
All of these features have been retained in 
the PC RP/M2 version. 

There are no restrictions on the type of 
programs you can run under PC RP/M2, so 
I tried DU.COM; it worked just fine. Of 
course, under RP/M2 you can’t directly 
access an MS-DOS hard drive, so it is per- 
fectly safe. As with CP/Mulator, all stand- 
ard CP/M programs worked exactly as 
they should. The few differences in execu- 
tion speed were minor. 


SUMMARY 

Both CP/Mulator and PC RP/M2 do what 
they are supposed to do: allow IBM PCs to 
run CP/M programs using the NEC V-20 
CPU. They are different in price: $129 for 
RP/M2 versus $79.95 for CP/Mulator. 
They both offer similar performance in 
terms of execution speed for various 
benchmarks. So how do you choose? 

PC RP/M2 is similar in function to CP/ 
Mulator in that it allows you to use your 
old CP/M programs on your MS-DOS ma- 
chine. It clearly has quite a different phi- 
losophy, however. It offers several features 
that are not supplied by CP/Mulator, in- 
cluding terminal emulation so that your 
CP/M programs will display properly. CP/ 
Mulator suggests that you load ANSLSYS, 
but some CP/M programs do not allow the 
long escape sequences necessary for an 
ANSI terminal. RP/M2 provides a utility 
to read many CP/M disk formats, while 
CP/Mulator has no such utility. RP/M2 
supports all BDOS and CBIOS calls, while 
CP/Mulator does not. On the other hand, 
CP/Mulator allows your CP/M programs 
to access data directly on your MS-DOS 
disks, while RP/M2 requires that you 
transfer MS-DOS data files from an MS- 
DOS disk over to an RP/M2 disk first (and 
then back if required). CP/Mulator as- 
sumes you will use familiar MS-DOS com- 
mands for housekeeping, while RP/M2 re- 
quires that you use one set of 
housekeeping commands under RP/M2 
and a different set under MS-DOS. 

For the casual user of well-behaved CP/ 
M programs, I would recommend CP/ 
Mulator because it allows you to run trans- 
parently under MS-DOS, using MS-DOS 
files, and allows a consistent use of operat- 
ing-system commands. But for the serious 
hacker or individual who does a fair 
amount of programming under CP/M, I 
would rate PC RP/M2 as the better pro- 
gram. Its many utility programs are a nice 
extra that make it worth the additional 
cost. § 
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PRODUCT INFORMATION 


RP/M2 

$129 + $5 shipping ($10 non-US.) 
Micro Methods, Inc. 

118 SW First St., Box G 
Warrenton, OR 97146 

(503) 861-1765 


CP/Mulator 

$79.95 (includes V-20 chip) 
$49.95 (software only) 
Source Information 

Box 2974 

Warminster, PA 18974 
(215) 441-8178 


PC-PRO 
IS 
PC-DOS 


for 
CompuPro/ Viasyn 


e PC DOS Ver 3.1 


e PC Graphics Support 


for information write 


( omputer House, Inc. 


P.O. Box 709 Woodacre, CA 94973 
(415) 453-0865 


Trademarks: Viasyn Corp., 
PC-PRO - Computer House. 
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PORT-A-SOFT 
Aardvark to Zorba 


We Can Handle It 


TRANSFER 
PROGRAMS, DATA AND 
OTHER FILES BETWEEN 
OVER 400 COMPUTERS! 

13 OPERATING SYSTEMS 


WORD PROCESSORS TOO!! 


Prices From $7.00 Per Disk 
Software and Hardware So You Can Do Your Own 


Call or write today for your 
FREE CATALOG 


P.O.BOX1685 5555S. STATE, STE. 12 
OREM, UT 84058 (801) 226-6704 


COMPLETE SOURCE CODE INCLUDED! 


ICXPDS: eXchanger now supports the 5 1/4”iPDS format. Manipulation 
of ISIS-II files using your computer system was never easier. 


ICXMDS: Same as ICXPDS, but for MDS 8” systems. 
IMXPDS: ReadsMrites 5” iPDS disks on PC’s and AT’s. 


TELEDPLUS: Enhanced serial file transfer program for CP/M, ISIS, 
or MS-DOS. 


TSE: Emulator gives the CP/M and MS-DOS user access to all the ISIS-II 
languages and utilities. 


ACCELER 8/16: CP/M-80 emulator for MS-DOS. Enables PC's 


to run ISE. (no source code, V-20 incl.) $89 each 
$250 any 3 above 
UDI: The 8086 ISIS Emulator runs all UDI applications. 
a ES SE 
ZAS Development Package: Z-8 and Z-8000 
Assembler for CP/M, ISIS, and MS-DOS. 


Request a catalog of our products! 


Copyrights:CP/M Digital Research. Ing 
ISIS-I] and iPDS Intel Corp. MSOOS Microsoft 


Western Wares 303-327-4898 


BoxC * Norwood. CO 81423 
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TOTALCONTROL 
with LMI FORTH™ 


~ 4 
For Programming Professionals: 


an expanding family of 
compatible, high-performance, 
Forth-83 Standard compilers 
for microcomputers 


For Development: 

Interactive Forth-83 Interpreter/Compilers 

¢ 16-bit and 32-bit implementations 

e Full screen editor and assembler 

e Uses standard operating system files 

¢ 400 page manual written in plain English 

¢ Options include software floating point, arithmetic 
coprocessor support, symbolic debugger, native code 
compilers, and graphics support 


For Applications: Forth-83 Metacompiler 

¢ Unique table-driven multi-pass Forth compiler 

* Compiles compact ROMable or disk-based applications 

e Excellent error handling 

¢ Produces headerless code, compiles from intermediate 
states, and performs conditional compilation 

* Cross-compiles to 8080, Z-80, 8086, 68000, 6502, 8051, 
8096, 1802, and 6303 

¢ No license fee or royalty for compiled applications 


For Speed: CForth Application Compiler 


¢ Translates ‘high-level’ Forth into in-line, optimized 
machine code 
¢ Can generate ROMable code 


Support Services for registered users: 


* Technical Assistance Hotline 
¢ Periodic newsletters and low-cost updates 
¢ Bulletin Board System 


Call or write for detailed product information 
and prices. Consulting and Educational Services 
available by special arrangement. 


a F 
Laboratory Microsystems Incorporated 
| fie Office Box 10430, Marina del Rey, CA 90295 
Phone credit card orders to: (213) 306-7412 


Overseas Distributors. 

Germany: Forth-Systeme Angelika Flesch, Titisee-Neustadt, 7651-1665 
UK: System Science Ltd., London, 01-248 0962 

France: Micro-Sigma S.A.R.L., Paris, (1) 42.65.95.16 

Japan: Southern Pacific Ltd., Yokohama, 045-314-9514 

Australia: Wave-onic Associates, Wilson, W.A., (09) 451-2946 
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The UNIX File 


by lan Darwin 


This column discusses the UNIX operat- 
ing system. If you have comments or 
questions about UNIX or this column, 
please write to Ian Darwin at Box 603, 
Station F, Toronto, Ontario, Canada 
M4Y 2L8. If you have UNIX mail access 
to. the uucp network, — mail 
“ihnp4!darwintian.” I can’t always an- 
swer immediately, but I will get back to 
you, electronic mail gets answered first! 


This installment of your UNIX column 
finds out what some high-speed UNIX 
boxes have in common, writes down some 
unwritten rules, and looks at sharing a 
phone line between dialin and dialout. 


THE VME BUS 

Microcomputer makers are always look- 
ing for ways to build faster systems. They 
want good CPU chips, and they want them 
running at high clock rates. For a given 
CPU type and speed, the fastest system 
will usually be a single-board computer 
with the memory, video or serial I/O, and 
disk controllers all on one board. But sin- 
gle-board systems typically limit the user’s 
flexibility. A bus in the computer world 
provides a means of transporting not peo- 
ple but signals from one place to another. 

A bus connects several circuit boards to- 
gether to make a complete system. Many 
of us grew up with the S-100 bus. The ma- 
jority of computers sold today use newer, 
faster buses. 

Today a new bus architecture is attract- 
ing most of the press attention and manu- 
facturer interest. The VMEbus is derived 
from Motorola’s VERSAbus. The bus is 
supported by the VMEBus International 
Trade Association (VITA) and is undergo- 
ing the final stages of approval as an IEEE 
standard (P1014/D1.2) and an Interna- 
tional Electrotechnical Commission 
standard (IEC 821). The architecture is de- 
signed and spelled out in considerable de- 
tail for total interchangeability (the VITA 
version of the bus specification is 261 
pages long). The spec is intended to allow 
boards to communicate quickly and reli- 
ably. It also goes into detail on the me- 
chanical specification of boards and 
mountings, to ensure compatability 
among manufacturers. The basic format is 
Eurocard, so that Eurocard cabinets and 
mountings can be used. One overall design 
goal is to ensure that system throughput is 
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limited by the devices making it up rather 
than by the time needed to transfer data 
among them. 

A detailed article on the VMEbus is be- 
yond the scope of this column. What mat- 
ters for UNIX users is that many of the top 
system vendors have adopted the VMEbus. 
Sun Microsystems’ line of Sun-3 worksta- 
tions runs Motorola 68020 CPUs on the 
VMEbus with a UNIX derived from 4.2- 
and 4.3BSD. Dual Systems’ Chapparel 
product line features MC68020 on the 
VMEbus with a standard System V. Inte- 
grated Systems, Inc. (ISI) Optimum/V 
computers (V is for VME) run Motorola 
CPUs. The list goes on. There is even an 
AT&T 32xxx offering. 

Hence, the purchaser of a VME-based 
computer has a wide range of suppliers to 
turn to for add-on peripheral boards. In- 
deed, some parts of the Sun-3 computer 
are not made by Sun; for example, the 
SMD controller is made by Xylogics. And 
Dual Systems sells its VME boards to 
other system builders. Memory boards of- 
ten have specialized interfaces to the CPU, 
but most peripheral boards are portable. If 
you can add a driver to your UNIX kernel, 
you can add the peripheral to your system. 

There are many other reputable makers 
of VME boards and systems. I list these 
companies because I know their products, 
and because they are UNIX vendors. 

And their machines are fast. Sun-3 sys- 
tems offer excellent price/performance. 
Dual’s systems are good, although I 
haven’t yet had a chance to review the 
speed of their 68020 systems. While the 
bus design is not the only factor in building 
a fast computer, a slow bus can limit per- 
formance as effectively as any other fac- 
tor. These vendors’ systems, and others 
that are coming to market prove that it’s 
possible to build fast computers using the 
VMEbus. 

For more reading, see The VMEbus 
Specification, Rev C.1 (or later), publica- 
tion number HB212 (no ISBN), available 
from Motorola and elsewhere. 


MAKE—SOME UNWRITTEN RULES 

In day-long talks I give on Effective UNIX 
Programming, I spend considerable time 
talking about unwritten rules—that is, 
rules that are followed almost instinctively 
by old-timers but that don’t appear in the 
manuals. Because they’re not in the man- 
uals, such rules are often missed by new- 


comers. Following them will make your 
software behave as part of a consistent 
whole with the rest of the software distrib- 
uted in the UNIX community. 

I will list some of these unwritten rules 
at intervals in my column. For starters, 
here is a list of rules for the make utility. 
These won’t make much sense unless you 
know about make; check out the manual 
or see my discussion in previous columns 
for an introduction to this utility. 


1. If there is a rule to install the generated 
program in a bin directory, this rule 
should be called install—not cp, not copy, 
not ins, not putit, but install. Software that 
is consistent is a lot easier to use than soft- 
ware that isn’t. 

2. If there is an install rule, it should de- 
pend on the targets that you want to in- 
stall. 

Typing “make install” should do the 
right thing; it should ensure that the pro- 
gram is built and up to date before you try 
to install it. 

3. There should be a make rule to delete 
transients such as .o files. This rule should 
be called “clean.” You should be able to 
say “make clean” to put the directory 
back in a moderately pristine stage. 

4. The most important target should be 
first, since the first target is the default. 
Typing “make” with no arguments should 
do something intelligent. Beware of using 
.DEFAULT; it has some unusual side ef- 
fects on some versions of UNIX. 

5. A rule that runs some common software 
tool such as lint should have the name of 
that program. Calling the lint rule “lint,” 
not “check” or “verify,” is just a matter of 
saying what you mean in a way that will 
be understood most readily by another 
programmer. 

6. Every makefile that generates one or 
more C programs should have a lint rule to 
run lint on the set of functions in the pro- 
gram. 

7. As with any programming language, 
symbolic constants should be used at the 
start of the makefile to identify variables, 
such as BINDIR (or BIN_DIR) for the di- 
rectory in which the binary programs get 
installed, MANDIR for the manual page 
directory, etc. These are much easier to 
find than path-names scattered through- 
out the makefile. 

8. No make rule should unexpectedly re- 
move or overwrite source language files. 

Many of the unwritten rules that I am 
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trying to preserve are concerned with 
making software do the right thing—that 
is, with making UNIX software behave 
consistently. 


SYSTEM V LINE TURNAROUND 
Owners of many small UNIX systems 
want to have a single telephone line that is 
used for dialin and dialout consecutively. 
The System V developers have realized 
this, and now offer a getty variant called 
uugetty that, combined with a modified cu 
program, allows a line to turn around 
automatically. But it’s not yet in all the 
UNIX boxes in the field. Here is a tech- 
nique you can use on early System V sys- 
tems and even, I suspect, on System IIL. 
The overall plan is to use two different 
init states, one in which the line is an- 
swered and another in which it’s not. I use 
states 2 and 3, respectively. You need a 
way to flip from one state to another 
quickly and easily without disrupting ex- 
isting logins or dial-outs. My solution to 
that is a couple of shell files, “dialin” and 
“dialout.” You also need a way to prevent 
uucp from trying to dialout on the line 
when it is in dialin mode. My solution to 
that is the lockit program. 


First, is the “‘inittab” entry I use for my 
terminal line (shown in Listing 1). The 
lines beginning with # are comments to 
init. The first column is just unique names. 
The second column—2, in both cases—is 
the init state. That says that in init state 2, 
both /etc/lockit and /etc/getty will be 
run; when init is changed to any state 
other than 2, both programs will be termi- 
nated automatically by init. Lockit just 
creates a dummy lock file. Getty is the 
program that monitors the phone line, 
waiting for somebody to try to log in. On 
my system, /dev/cul0 and /dev/tty03 are 
links to each other; cul is what you had to 
name your dialout line when I learned 
UNIX. 

You could get by with just the above 
and manually flip by typing 


telinit 2 
or 
telinit 3 


to turn the line around. But you’d have to 
be careful not to do so when anybody was 
logged in (the user would be kicked off) or 
when anybody was doing a cu or kermit on 
the line. Here is a shell file called dialout 
that makes sure nobody is logged in; if not, 
it goes ahead and calls init to change state. 


: dialout -- switch shared line to 
dialout 
. if nobody is logged inon 
it. 
whoigreptty03 && exit 


telinit 3 
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The && exit is a simple way of ter- 
minating a shell script when something 
succeeds that shouldn’t. Note that this 
script relies on grep correctly reporting 
exit status. 

The reverse operation is dialin; if no- 
body is using cu or kermit, and uucico isn’t 
running, it is safe to enable dialins on the 
line. 


dialin -- switch shared line 
to dialin ps -ae | egrep ' 
(uucicokermiticu)' && exit 
/etc/init 2 


By now you've probably realized that 
you have to be the superuser to run these 
programs. But set-userid shell scripts are 
inherently unsafe. What can you do? You 
can use a simple C program that is setuid, 
takes no arguments, and passes control to 
the shell file. If you’re the only user on 
your system, you don’t need this—just do 


su root -c 'dialin' 

But for a small multiuser system, you 
need some way of keeping control while 
allowing other people to dial out. This is 
shown in listing 2. 

Standard( ) is a local function that stan- 
dardizes PATH and other important envi- 
ronment variables, to head off certain se- 
curity attacks. Just compile this program 
twice, once for dialin and once for dialout. 

The lockit program is a page of code 
that does the obvious: check for the lock 
file, create it, and pause; catch SIGTERM 
and remove the lock. This program should 
also be in C and must be setuid to uucp to 
create a lock in the uucp directory. If you 
need a copy, just send me a uucp address 
or a return-addressed envelope. 

There are certainly better ways of solv- 
ing this. Later releases of UNIX will cer- 
tainly include them. The best way, from 
the phone company’s point of view, might 
be to install a second phone line. 

That’s all for this month. I welcome let- 
ters and electronic mail on these and other 
topics, especially suggestions for future 
columns. § 


VENDORS 

Dual Systems 

2530 San Pablo Ave. 
Berkeley, CA 94702 
(415) 549-3854 


Integrated Solutions, Inc. 
1140 Ringwood Ct. 
San Jose, CA 95131 
(408) 943-1902 


Sun Microsystems 

2550 Garcia Ave. 
Mountain View, CA 94043 
(415) 960-1300 


Turn to page 81 for Listings 


Byte Magazine called it. 


‘CIARCIA’S 
SUPER 
SYSTEM" 


The SBI80 
Computer/Controller 


Featured on the cover of Byte, Sept. 1985, 
the SB180 lets CP/M users upgrade to a 
fast, 4” x 7%” single board system. 


e@ 6MHz 64180 CPU 
(Z80 instruction superset), 256K RAM, 
8K Monitor ROM with device test, disk 
format, read/write. 

e@ Mini/Micro Floppy Controller 
(1-4 drives, Single/Double Density, 
1-2 sided, 40/77/80 track 3%'/5%"" 
and 8” drives). 

@ Measures 4” x 7%"! with mounting holes 

@ One Centronics Printer Port 

© Two RS232C Serial Ports 
(75-19,200 baud with console port 
auto-baud rate select). 

© Power Supply Requirements 
+5V +/-5% @500 mA 
+12V +/- 20% @40mA 

@ ZCPR3 (CP/M 2.2/3 compatible) 

© Multiple disk formats supported 

e@ Menu-based system customization 


S$B180-1 
$B180 computer board w/256K 
bytes RAM and ROM monitor 


Susiiandghoepawadasdniapauaansehinkcaiy $299.00 
$B180-1-20 

same as above w/ZCPR3, ZRDOS 

and BIOS source............. $399.00 


-Quantity discounts available- 


new 
COMM 180-M-S 


optional peripheral board adds 
1200 bps modem and SCS! 
hard disk interface. 


TO ORDER 
CALL TOLL FREE TELEX 
1-800-635-3355 643331 


For technical assistance or 
to request a data sheet, call: 


1-203-871-6170 


(4 las Micromint, Inc. 
4 Park Street 


Vernon, CT 06066 
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The Scientific 
Computer User 


FORTRAN to DOS 
Epsilon 
SR ERA RENO OEE 


FORTRAN TO DOS 

Have you ever wished that you could com- 
pile and link a FORTRAN program and 
have it accept parameters from the com- 
mand line when you run it? Or that you 
could play some fancy tricks with your 
video display? Or that you could manipu- 
late bits? Or do any number of other 
things from within FORTRAN that you 
have until now only been able to do using 
DOS commands or C or assembly- 
language programs? 

Actually, this has always been possible: 
you could interface FORTRAN programs 
to assembly-language routines, but this 
has always been something of a hassle. 
Now it is easy with the FORTRAN to DOS 
Interface ($59.95 plus $4.00 handling 
from Kris Jamsa Software). This is a set of 
FORTRAN-callable subroutines and func- 
tions that perform these various functions. 
The vendor claims there are more than 85 
of these routines; I counted 87. 

The file-manipulation routines enable 
you to open, delete, rename, and manipu- 
late file dates and attributes, and do other 
things with files and directories. Under the 
heading of hardware control, you can ini- 
tialize the printer and get its status, find 
your current disk drive and change it, find 
the memory size and get free disk space, 
and read and write bytes and words to any- 
where in memory. With video control, you 
can change screen colors, read and write 
pixels, scroll a region, set character 
attributes, and freely manipulate the cur- 
sor, among other things. System-interface 
routines enable you to get and set date and 
time and interrupt vectors, print the screen, 
define keys and do other keyboard pro- 
cesses, handle reboot and similar processes, 
play with segments and flags within DOS, 
and retrieve command-line parameters. 

Many of these processes are ones that 
you would take for granted to be available 
as FORTRAN routines on mainframes and 
minicomputers. It is sad commentary on 
current FORTRAN vendors for PCs that 
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very few of these routines have been pro- 
vided by them. 

The vendor provides two floppy disks 
providing these routines separately for the 
Ryan-McFarland, Microsoft, and Lahey 
FORTRAN compilers. You normally 
would just add the FTODOS library to 
your hard disk, but the vendor has also 
supplied complete FORTRAN and 
assembly-language source code for all the 


routines. Thus, you can customize the: 


routines and also learn a lot of interfacing 
techniques as well with these sources. 

It is obvious that many DOS services 
would not be included among the routines 
because it would make no sense to do so. 
Also, not every routine uses a DOS service; 
for example, changing colors on the screen 
is accomplished by sending ANSI escape 
sequences. Furthermore, some of the 
routines require DOS 3.*; unfortunately, 
the very useful routines that retrieve 
command-line arguments are among 
these. 


EPSILON 

As I write this, I am awaiting delivery of a 
Sun 3/260 workstation. This is at the top 
end of the microcomputer spectrum, and I 
shall have some things to say in future col- 
umns about its characteristics and why I 
chose it. For now, however, I want only to 
discuss an editor that I have been using in 
anticipation of the arrival of the Sun. 

The Sun utilizes the UNIX operating sys- 
tem. Unfortunately, that rules out any pos- 
sibility of using PMATE, my favorite editor 
(see my discussion of this editor in the July- 
August, 1986, issue of Micro/Systems 
Journal). For years people have been com- 
plaining about the lack of good UNIX soft- 
ware. There are two “official” UNIX edi- 
tors. One is ED, which is the UNIX 
equivalent of EDLIN of MS-DOS infamy. 
Need I say more about that one? The other 
is VI, which has the advantage of being a 
screen editor, but I am unable to think of 
anything else good to say about it. There is 
also EMACS, a public-domain editor, 
which has the reputation of being the best 
that one can get under UNIX. The DOS 
equivalent of this is Epsilon (from Lugaru 
Software; I paid $169 for it by mail order). 
I purchased this editor in order to become 
familiar with it in anticipation of getting 
EMACS for the Sun, and in order to be able 
to use essentially the same editor on PCs 
that I would be using on the Sun. 

EMACS is written in LISP, but Epsilon is 
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written in C. It also has extensive capabili- 
ties for customization, giving the sources 
for the various types of operations in what 
it calls the Epsilon Extension Language, 
which is almost indistinguishable from C 
itself. I have not yet tried to customize Ep- 
silon, since I wanted to have some experi- 
ence with EMACS on the Sun first, and 
then to customize the two forms of the edi- 
tor together. 

Epsilon has a vast array of commands. 
Some of these are “bound” to keys on the 
keyboard, so that they form instant com- 
mands. You call others by entering a form 
of command mode and typing enough of 
the (usually lengthy) command name to 
make it uniquely recognizable. The editor 
makes good use of the keypad keys, by 
themselves and in combination with the 
Control and Alt keys. It makes very poor 
use of the function keys, placing on them 
commands that are rarely used. In general 
I dislike commands that require me to de- 
press Shift or Control or Alt in combina- 
tion with other keys; I would prefer single 
keystroke commands. However, Epsilon 
operates by entering ordinary keystrokes 
as text under most circumstances, so that 
in general something must be used in com- 
bination with ordinary keys to execute 
commands. That is why I am unhappy 
that more common commands are not im- 
plemented on the function keys. 

PMATE suffers from the limitations of 
its CP/M background in having only a very 
limited text buffer—so that a lot of slow 
buffering to disk is necessary—and in not 
allowing simultaneous display of two or 
more windows on the screen. To me the 
most immediate benefit of Epsilon is to be 
rid of these two limitations. Thus, already 
I find byself bringing up Epsilon to deal 
with long files and in order to see two files 
or two parts of the same file at the same 
time. Actually, Epsilon can display 12 
windows at once, each containing one line 
of text and one status line. I do not foresee 
needing that much flexibility. 

Epsilon can use macros in the form of | 
sequences of keystrokes which can be 
stored and executed. Unfortunately, this 
facility falls far short of that available in 
PMATE, since Epsilon lacks the condi- 
tional statements available in the PMATE 
command language. Hence, even if Epsi- 
lon becomes my editor of choice, I will still 
need PMATE to do more complicated edit- 
ing with macros. 

The Epsilon manual is terse and lacks 
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very many examples and clearly is written 
for users with a programming background. 
The help facility is useful only if you can 
remember the often-complicated name of 
the command you want to see defined. For- 
tunately, Epsilon comes with a variant on 
the standard EMACS tutorial, and in fact 
that is very useful for getting started. 

PMATE writes directly to the screen, and 
so screen changes appear blazingly fast. 
Epsilon appears to “obey the rules” in using 
DOS services, so that screen updates are no- 
ticeably slower, but they are fast enough 
not to be really annoying. However, one 
feature that is annoying is the lack of auto- 
matic reformatting of the text as changes 
are made, as is done in PMATE. You must 
reformat paragraphs or regions manually, 
and the reformatting procedure takes 
rather a long time. The procedure must be 
rather inefficient. Fortunately, since most 
writing I do is formatted for use with TEX, 
having very uneven lines in a paragraph 
does not affect the final appearance of the 
output, so reformatting is unnecessary ex- 
cept for the sake of neatness. 

There is a considerable amount of awk- 
wardness in erasure and cutting and past- 
ing operations in Epsilon. Erasure of single 
characters is usually not recoverable, pre- 
sumably on the mistaken idea that a miss- 
ing letter will always be obvious. Cutting 
and pasting involves use of a “kill” buffer: 
outline a region with a mark and the cur- 
sor, copy or move the region to a buffer, 
move the cursor to the new location, and 
fetch the text from the buffer. That se- 
quence is fairly standard. But the default 
configuation is only one kill buffer. You 
must go to the effort to create additional 
kill buffers if you want to be able to save 
several sequences of kills. The PMATE 
procedure is much better: have one large 
kill buffer and save there everything that 
is deleted, including individual characters, 
as long as there is room. Also, have many 
additional buffers (by default) into which 
text can be moved and in which editing 
can be done. These are the PMATE equiv- 
alent of windows, suffering only from the 
lack of ability to be displayed more than 
one at a time on the screen. Epsilon can 
create lots of buffers, and you can attach 
these at will to a screen window for edit- 
ing, so in that respect it is somewhat simi- 
lar in function to PMATE. 

The bottom line for me is that I find 
Epsilon to be a generally acceptable edi- 
tor, one with some features that are supe- 
rior to those in PMATE. § 


A.G.W. Cameron is Professor of Astron- 
omy at the Harvard-Smithsonian Center 
for Astrophysics, 60 Garden Street, Cam- 
bridge, MA 02138. 


ADDRESSES 

Kris Jamsa Software, Inc., P.O. Box 26031, 
Las Vegas, NV 89126. 

Lugaru Software Ltd., 5740 Darlington Rd., 
Pittsburgh, PA 15217; (412) 421-5911. 
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Unix Code 
Continued from page 79 


LISTING 1 


# stuff below here == kludges due to single phone line 


# note - tty03 == cul0d 


1k:2:once:/etc/lockit -w cul0 # keep tip and uucico down 
03:2:respawn:/etc/getty tty03 du_1200 # Shared line 
# for init state 3, both lockit and getty disappear, allowing dialout 


LISTING 2 
/* 
* setuidsh - setuid front end to sh script 
* set up as 
* cc -DSHPROG= 
* mv foo $HOME/bin/foo 
* chmod u+s SHOME/bin/foo 
ia 


#include <errno,h> 


main(argc, argv) 
int argc; 

char *argv[]; 

{ 


extern int errno; 
standard(); /* for a clean environment */ 


setgid(getegid()); 
setuid (geteuid()); 


execv(SHPROG, argv); 

#ifdef USG 

iff (errno == ENOEXEC) { /* Sys V can't exec shell 
execl("/bin/sh", "sh", "-c", SHPROG, 0); 

} 

#endif 

perror (SHPROG) ; 

exit (1)? 


END OF CODE 
/pin/sh", “sh", "-c", SHPROG, 0); 
} 
#endif 
perror 


files, darn */ 


PC/Blue Repor 


by Hank Kee 


M/SJ ownership has changed but the edi- 
torial management remains the same. In 
future issues of M/SJ, there will be a new 
public-domain software column that will 
combine Sig/M and PC/Blue Report. 
Steve Leon, my amiable colleague, will be 
writing the column. I will continue to edit 
the PC/Blue library. This will give me time 
to do some comparative product analysis, 
which will appear in future issues. 


THE SHAREWARE CONCEPT 

This, my final column on PC/Blue public- 
domain software, will be a report to the 
readers from a different perspective. 
There has been much discussion about the 
merits of shareware software. This is a 
class of software in which authors encour- 
age users of their software to copy and dis- 
tribute the software without charge. These 
programs are copyrighted and contain re- 
quests for donations. These programs are 
normally found on remote bulletin-board 
systems and distribution libraries such as 
PC/Blue. Their quality is generally quite 
high. Most have complete documentation. 
In some cases, such as modem-communi- 
cations programs, they are the equal of 
commercially available programs. 

When I was librarian (and founding 
editor) of the Sig/M library of CP/M 
public-domain software, I only accepted 
programs for inclusion in the library that 
included source code and had no distribu- 
tion restrictions. This was the hacker 
credo at the time. Although some of the 
programs may have contained a copyright, 
permission was always sought and re- 
ceived to distribute them freely for non- 
commercial use. Steve Leon, the current 
editor of the Sig/M library, has continued 
this tradition. The concept of collecting, 
editing, and distributing the PC/Blue li- 
brary of PC programs was started in the 
same tradition. 

Then, the late Andrew Flugelman came 
up with the idea of shareware. His popular 
PC-Talk communications program was the 
first such program. His idea for marketing 
his program was simple. If you tried it, 
liked it, and decided to use it, he requested 
a voluntary donation. His concept is now 
being used by countless aspiring entrepre- 
neurs, so that now most of the contribu- 
tions to the PC/Blue library are shareware 
programs. 
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Each year it becomes more difficult to 
get started in the software business. 
Where just a few years ago you could start 
on a shoestring, today that effort requires 
large amounts of capital. Marketing (pro- 
motion and distribution) has become more 
important than performance. The result is 
that many good programmers are discour- 
aged, and their programs never get seen or 
used by others. 

Distribution of software through the 
PC/Blue and other public-domain soft- 
ware libraries, as well as remote bulletin 
boards, has given many authors opportu- 
nities they would not have had otherwise. 
For many, it has brought programming 
talents to the attention of established soft- 
ware publishers and led to jobs they would 
not have gotten otherwise. The donations 
have also encouraged many to develop 
more good software and put it into the 
public-domain. 

Many of the programs that started in 
the public-domain are now also sold com- 
mercially. For example, the 3X5 In- 
formation Management program is now 
sold by MultiMate, a subsidiary of 
Ashton-Tate, under the name On-File. 
PC-File, the first shareware database- 
management system, was an immediate 
hit, and allowed the author, Jim Button, to 
quit his job and found his own company. 
Another program that made the success- 
ful transition is PC-Write. This, along with 
a few other noteworthy programs, makes 
up the Brown Bag company. Although 
they have gone commercial, many of these 
programs continue to be available in the 
public-domain software sector. 

Corporations are no longer looking at 
public-domain and user-supported pro- 
grams with disdain. Many of the larger 
corporations are responsible for the reve- 
nues received by user-supported authors. 

The software marketing cycle has now 
come to full circle. Many small, indepen- 
dent software distributors advertise com- 
mercial software for as low as $.75 (yes, 
that’s correct) a program. These programs 
are not being offered for a voluntary dona- 
tion, but are sold at an amount so nominal 
that it is tantamount to free software. 


NEW PC/BLUE RELEASES 

The following are recent releases in the 
PC/Blue library of public-domain and 
user-supported software: 


Volume 238 
Statistical Process Control v1.1 manufac- 
turing and assembly control 


Volume 239 
Images from the Mandelbrot Set 


Volume 240 


CalTech Utilities 

CTRLALT v1.0—a set of resident utilities 
taking roughly 6K RAM 

DFIX—tests any IBM-compatible disk or 
diskette for bad sectors, offers to mark 
bad sectors if not in use by a file 

FM—a visual hex-file editor 

KEGELUNX—a set of small utilities mod- 
eled after features of UNIX 

NANSI—a replacement and enhancement 
of ANSLSYS, with faster screen writing, 
etc. 

SEND—a replacement for ECHO, sup- 
porting an extension of the prompt 
metastrings 


Volume 241 

Managing Money with Your IBM PC 

Stock Trader v2.0—maintains selected 
stock prices 

Disk File Manager v1.0—maintains log of 
disk files 

The Program Wizard vl.0—program 
start-up menu shell 


Volume 242 

AT&T 6300 Technical Notes 

AT&T 6300 Clock/Calendar Utilities— 
Set 80 X 50 Video on AT&T 6300 


Volume 243 
QModem v2.20 


Volume 244 

PC-Class—a teacher’s gradebook by Aiga 
Publications 

COVER26—produces diskette cover 
listing 

MULTGLED—multiple global editing of 
files 

MEGASORT—text file sort utility 


Volume 245 
Structured Programming Language v1A 


Volume 246 


Kermit v2.29—modem communications 
system 
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Volume 247 

Turbo Pascal I/O routines 

Spelling Checker v1.2 
Programmable RPN Calculator v1.4 
Othello v3.0 


Volume 248 

Micro Development Software BASIC 
utilities 

Advanced Lotus 1-2-3 tutorial 

Symphony command language 

ARTificial Art 


Soren 
Volume 249-250 Ane FILE TAR LOS 


RBBS-PC v14.1d—remote bulletin-board 
system 


Hank Kee is the librarian for the PC/Blue 


public-domain software library. He col- curso® 
lects, assembles, and checks all the soft- Oo AN $ 
ware issued by PC/Blue and then com- ia nN 95 
piles and edits the programs into the =) Postage 
released volumes. § Paid 

MS-DOS & PC-DOS COMPATIBLE 

PUT YOUR PC’S TO WORK ON YOUR MULTIUSER... 
PC/Blue disks are available from the New | ; DIGITAL 
York Amateur Computer Club, Inc., Box [cid DECISIONS WORDSTAR* 
106, Church Street Station, New York, SYSTEMS MICROPRO INC. 
NY 10008. Price is $7 per volume, which SYSTEMS 
includes media, postage, and handling. On 229 Lakeview Ave. ¢ Clifton, NJ 07011 


foreign orders, please add $2 per disk. A 
printed directory is also available ($5 1-800-862-6233 ais ext oowree (201) 772-6749 


Vis. Canada Mexico; 57 loreagn), Call/Write for our FREE 140 page Color Catalog 


VALUE and PERFORMANCE 
ry yy) with Mitek’s 
Relocatable Z80 
Macro Assembler and 
Z80 Symbolic Debugger 


Relocatable Z8O Macro Assembler 
Only $49.95 plus shipping. @ Phase/dephase. 
8080 to Z80 Source Code Converter. © Cross-reference generation. 
® Generates Microsoft compatible @ Full Zilog mnemonics. 
° 
e 


REL files or INTEL compatible hex INCLUDE and MACLIB FILES. 
files. Separate data, program, common, 


Compatible with Digital Research and absolute program spaces. 
macro assemblers MAC & RMAC. e Supports Hitachi HD64180. 
Generates Digital Research compat- @ 780 Linker and Library Manager for 
ible SYM files. Microsoft compatible REL files avail- 
Conditional assembly. able as an add-on to Assembler. 


ATTENTION Turbo Pascal Users: 


Assembler will generate Turbo Pascal in-line machine code include files. 


PRICE LIST 
TO ORDER, CALL TOLL FREE: 1-800-367-5134, ext. 804 | z80 Macro Assembler: $49.95 
For information or technical assistance: (808) 623-6361 Assembler, Linker, and Library Manager: $95.00 


i ; 9 7 ‘ Manual Only: $15.00 
Specify desired 51" or 8” format. Personal check, cashier's check, ‘ 
money order, VISA, MC, or COD welcomed. | 280 Symbolic Debugger: $49.95 
Manual Only: $15.00 


P. O. Box 2151 Assembler, Linker, Library Manager, and Debugger: $134.95 
Honolulu, H! 96805 Include $5 for shipping and handling. 


Z80 is a trademark of Zilog, Inc. MAC and RMAC are trademarks of Digital Research, Inc. Turbo Pascal is a trademark of Borland International, Inc. 
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In the SIG/M 
Public Domain 


by Stephen M. Leon 


Steve Leon is the SIG/M Disk Editor. He 
assembles, compiles, and edits all of the 
SIG/M public-domain software disks. 
Thus, he speaks with the greatest author- 
ity as to what is going on in the SIG/M 
public-domain software area. 

Further, Steve operates a remote 
bulletin-board system for the Amateur 
Computer Group of New Jersey. Readers 
can contact Steve via his RBBS ((201) 886- 
8041). The system also contains a great 
deal of public-domain software available 
for downloading. 


One of the three new SIG/M volumes (289) 
contains some of the software uploaded to 
the BBS. Some of it is not particularly new, 
but it slipped between the cracks. FBAD is 
such a program. It is an improved version 
of FINDBAD, the bad disk sector lockout 
program. SETDRU, to set drive, and user 
path in CP/M 80, and SFILE13, which 
searches all drives, user areas and libraries 
for a file, seem quite handy. 

Also on the disk is a machine-specific 
program, by Joe Gugel, to allow Rainbow 
100 users to create an MDRIVE, a smart 
copy program, and Star Trek in Nevada 
BASIC. (Why another Star Trek? As Brian 
Beard commented, there are a lot of ver- 
sions around. But he was running Nevada 
BASIC and had to write one for it!) I antici- 
pate receiving something like 6-megabytes 
of Turbo Pascal programs for the BBS; 
hopefully, some of that material will also 
make its way onto SIG/M disks. 

David A. Danello donated a collection 
of FORTRAN subroutines and tools. They 
are to be found on SIG/M Volume 288. 
Also on the disk is a library containing an 
unrelated series of miscellaneous pro- 
grams also provided by Dave. They in- 
clude a Morse code decoder, a pretty good 
file-compare program, some interesting 
astronomy programs, and a mortgage- 
amortization calculator. I had a lot of fun 
with Stardate. When it first came in, I was 
not quite sure what an almanac from 2500 
B.C. to 2500 A.D. would do. Ted Camp- 
bell’s program gives you a whole slew of 
calendar, almanac, and astronomical data 
for the period. It is designed for the his- 
torian, the writer, or the curious. The file 
on SIG/M Volume 290 includes both 
CP/M and MS-DOS versions. 

Also on 290 is a Kaypro-to-IBM main- 


84 


frame-transfer program. Not having ei- 
ther a Kaypro or access to an IBM main- 
frame, I could not test it. It looks good. 
The documentation is professional. The 
source code is there, so it can be used for 
machines other than Kaypros. Dave May 
did what appears to be a good job on it 
and, as he says in the documentation, it 
has been used without problems for more 
than a year. 


CHANGES COMING 

In the next issue, this column and the PC/ 
Blue columns will be integrated into one 
column covering public-domain software. 
The new column will be broadened to 
cover other areas of public-domain soft- 
ware. It will even touch on public-domain 
software for the Atari ST and Commodore 
128 and Amiga. Readers who access my 
BBS system ((201) 886-8041) will find a 
considerable amount of Atari, Commo- 
dore, and MS-DOS public-domain soft- 
ware, as well as SIG/M software, available 
there for downloading. 

At last count, there were some 150 
public-domain programs for the Amiga, 
including a variety of languages, graphics 
and sound programs, utilities, and com- 
munications programs. SIG/M does not 
yet have a way of releasing this material in 
an Amiga disk format, but all Micro/Sys- 
tems Journal readers with an interest in 
the Amiga are welcome to download this 
material and to upload their programs to 
the system. 

On the system too are the recent SIG/M 
and PC/BLUE releases (all other SIG/M 
and PC/BLUE volumes are available on re- 
quest). Also on the system is much of the 
source code from Micro/Systems Journal 
articles. Much of the same material is on 
the BBS system Hank Kee runs for the 
New York Amateur Computer Club 
((718) 539-3560 and -3338). The big dif- 
ference between the systems is that the 
NYACC board requires registration con- 
firmation to upload and download. The 
ACGNJ board does not require registration. 

SIG/M volumes are available on 8-inch 
SSSD disks for $6.00 each ($9.00 foreign) 
directly from SIG/M, Box 97, Iselin, NJ 
08030. Volumes may also be ordered in 
most 5-inch formats (other than Apple, 
Commodore 64, or high-density format) 
for $7.00 each ($10.00 foreign). There is 


an additional charge of $2.00 for formats 
that require more than one disk to hold a - 
240K volume (such as SSSD formats). 
Printed catalogs are $3.00 each ($4.00 
foreign). Disks in a variety of formats may 
also be obtained through the worldwide 
SIG/M distribution network. The distribu- 
tor list is included with the printed catalog. 
A disk version of the catalog (Volume 00) 
is available for $6.00. It also contains the 
distribution list. Many bulletin boards 
have the software for downloading, and 
most new releases on available on the 
CP/M SIGs on CompuServe and GEnie. § 


NEW SIG/M PUBLIC DOMAIN 
SOFTWARE RELEASES 


Volume 288 

Utilities for Microsoft FORTRAN-80 
Morse code, astronomy, etc. 
FORTRAN subroutines 

FORTRAN tools 


Volume 289 

Utilities on the ACGNJ BBS 
Compare disks and files in CP/M 
Z80 HEX and ASCII file editor 

FBAD Bad sector locator 

SFILE13 Searches all drives for a file 

Nevada BASIC version of Star Trek 

Smart copy program 

Create MDRIVE on Rainbow 100 

Set drive and user path in CP/M 80 


Volume 290 
Stardate Almanac 
Kaypro to Mainframe Transfer program 


ELECTRICAL ENGINEERING PUBLIC 
DOMAIN LIBRARY STARTED 

A public-domain software library for elec- 
trical engineers has been started by Gerry 
Harrison, 36 Irene Lane East, Plainview, 
NY 11803, (516) 822-1697. Four disks 
are already available. They are in PC for- 
mat, contain programs in BASIC and Pas- 
cal, and cover topics such as optimization 
of networks, filter design, matching net- 
work design, and transient and network 
analysis. 
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OUT WITH THE OLD, IN WITH THE NEW 


If you are a dealer with old Molecular, OSM, TeleVideo, Altos, Northstar, Dynabyte, 
CompuPro, IBS, JC Systems, or any other 8-bit or 16-bit S-100 multiuser installation, you 
can now replace these systems and save your customer thousands of dollars on new 
high-speed 16-bit S-100+ technology. 


For a limited time, when you send us any of these 8-bit or 16-bit computers, L/F 
Technologies will credit you trade-in dollars toward the purchase of new, high 
performance LFT 16-bit computer systems. 


We will trade you board for board, drive for drive on all complete systems — regardless of 
present operating condition! 


HERE’S WHAT YOU GET 


1) Huge dollar credits for your old hardware when you 
buy new, high performance LFT technology. 


2) A ONE YEAR WARRANTY on all new upgrades purchased. 


3) Super performance featuring 10MHz processors and 
high speed parallel bus. (We also offer 8MHz, 
8-bit systems) 


4) Options to add L/F Power, L/F Net, more storage, and 
more users. 


5) Factory technical support and service to replace 
discontinued company support. 


There are thousands of people with CP/M, MP/M, Concurrent DOS, N-Star, and 
TurboDOS computer systems, who have been abandoned. Now’s the chance to adopt 
orphans full of growth potential. 


Call L/F Technologies today for trade-in prices and upgrade details. 


TECHNOLOGIES 


MULTIUSER COMPUTERS FOR BUSINESS AND INDUSTRY 


L/F TECHNOLOGIES/CORPORATE OFFICES: 2800 LOCKHEED WAY, CARSON CITY, NEVADA 89701 + TELEPHONE: (702) 883-7611 » TWX: (910) 395-6051 
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New Products 


When contacting vendors, please mention 
that you read about their products in 
Micro/Systems Journal. 


S-100 HARDWARE 


WORKSTATION RUNS IBM 
SOFTWARE 


The Poppy workstation runs IBM PC soft- 
ware in an S-100 environment. It includes 
a processor board, smart cable, keyboard, 
and monitor. Based on an 80188 CPU run- 
ning at 8 MHz, 512K system RAM, 256K 
display RAM, and 4K ROM, it runs MS- 
DOS supported by the TurboDOS network 
operating system. Users can run virtually 
all popular IBM PC programs such as Lo- 
tus 1-2-3, Wordstar, and dBASE III, in a 
multiuser, multiprocessing environment. 
Monochrome, CGA, EGA and Hercules 
display options with automatic switching 
between modes are available. The Poppy 
workstation is also Novell-compatible. 

The Poppy workstation is $1,995 and is 
available from Charter Information 
Corp., 2421 Rutland, Austin, TX 788758, 
(512) 835-1111. 


14-USER MULTIUSER SYSTEM 

The CompuPro MP14 is a multiuser S-100 
system supporting up to 14 users. It uses 8 
CPUs (80286 and 80186 running at 10 
MHz with no wait states), 6.5Mb of RAM, 
disk caching, high-speed hard disks, and 
Concurrent-DOS. It is intended for high- 
performance environments in which all us- 
ers are accessing shared databases at the 
same time. It provides PC-DOS compati- 
bility as well as compatibility with all ex- 
isting CompuPro systems (Model 10, 
286/40, 286/80 and C3). 


The CompuProl4 is $18,995 and is 
available from CompuPro/Viasyn Corp., 
26538 Danti Court, Hayward, CA 94545, 
(415) 786-0909. 


NETWORK PROCESSOR 

The ICM CPS-16F is an S-100 network 
processor designed for use in multiuser/ 
multiprocessing systems. It is capable of 
running CP/M-80/86 and PC/MS-DOS. It 
contains an NEC V30 microprocessor and 
is compatible with 8- and 16-bit S-100 sys- 
tems with extended address capability. 
When used with ICM’s MS-100 software 
and an M/STER PC-compatible terminal, 
it allows you to run PC/MS-DOS pro- 
grams. You can run TurboDOS and PC/ 
MS-DOS on the same system. 
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The CPS-16F has 1Mb of RAM (no wait 
states), real-time clock, and two serial and 
two parallel ports. For additional informa- 
tion, contact InterContinental Microsys- 
tems, 4015 Leaverton Court, Anaheim, 
CA 92807, (714) 630-3714. 


PC-COMPATIBLE 
HARDWARE 


MULTIUSER/MULTITASKING ADD- 
IN BOARD 

The PCplex is a plug-in board for PC/XT/ 
AT systems that allows three users to work 
on the same system by attaching two 
ASCII terminals to existing ports. The ter- 
minals can be remotely connected via mo- 
dem. It allows up to 99 concurrent tasks 
and switching of computer screen and key- 
board to different tasks. It supports time 
slicing, Novell record and file locking, and 
up to 16Mb of memory via bank switch- 
ing. It provides user ID and password se- 
curity, protected file transfer, and a line 
analyzer of serial ports. 

A menu-driven installation program is 
provided, and the operating system resides 
in ROM. The basic model is $199. A ver- 
sion with two COM ports and an advanced 
system programmers’ utility package is 
$399. For information contact Xmark 
Corp., 3176 Pullman St., #119, Costa 
Mesa, CA 92626, (714) 556-9210. 


HIGH-RESOLUTION /HIGH-SPEED 
GRAPHICS SYSTEM 

The Retrograph One VT640 is a mono- 
chrome graphics system for IBM PC/XT/ 
AT and compatible systems. It includes a 
19-inch monitor displaying 1280 X 960 
pixels at one million pixels per second. It 
also provides intelligent printer output. 
Vectors, arcs, circles, and paint functions 
are done in hardware. Features include 
true zoom and true text over graphics. 
Plotter output is also provided. Compati- 
ble hosts include VT100, DOS, Tek 4010/ 
4014, Plot 10, and Hercules. A mouse op- 
tion is also available. 


The price is $2,995, and it is available 
from Retrographics Inc., 65 Commerce 
Rd., Stamford, CT 06902, (203) 637- 
1708. 


67 TO 268MB BACKUP FOR 
NETWORKS 

The ADIC Model 532 is a .25-inch 
cartridge-tape subsystem for large net- 
works using the Novell NetWare or 
Microsoft MS-NET software. The Model 
532 stores 67Mb. Up to three Model 530 
tape-expansion subsystems can be daisy- 
chained to a 532 host to provide up to 
268Mb of tape storage. The tape unit em- 
ulates a disk drive and provides random 
file access. Programs can be executed di- 
rectly from tape, allowing the user to de- 
fault to the tape system in the event of a 
total disk failure. Software is provided for 
installation and operation. 

The Model 532 lists for $3,490, and the 
Model 530 lists for $2,640, from Advanced 
Digital Information Corp., Box 2996, Red- 
mond, WA 98073, (206) 881-8004. 


ERE VT 
OTHER PRODUCTS 


ASYNCHRONOUS TO 
SYNCHRONOUS CONVERTER 

The Astrocom ATS-1 is a new ASCII 
asynch-to-sync converter. It selectively re- 
moves stop bits and synchronizes the re- 
maining bits with the receive clock from 
the synchronous transmission device. It 
provides auto-speed adjustment to support 
data rates from 12 to 19.2K bps and 5- to 
10-bit data character sizes. It includes a 
64-bit buffer, break detection, and front- 
panel LEDs. 
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The ATS-1 is $395 and is available from 
Astrocom Corp., 120 W. Plato Blvd., St 
Paul, MN 55107, (612) 227-8651. § 


MODEM/SCSI PERIPHERAL 
BOARD 

The Micromint COMM 180 is an expan- 
sion board for the SB180 computer. The 4 
X 5-inch board adds the functions of mo- 
dem and SCSI hard disk controller 
interface. 

The modem is Bell 103-212A compati- 
ble 300/1200 baud with Dual Tone Multi- 
frequency (DTMF) encode/decode or 
pulse dialing, call progress monitoring, di- 
agnostic capabilities, and voice synthesis 
capability allowing it to respond verbally 
to commands entered via touch tone. The 
modem addresses the bus directly and 
does not use the SB180 serial port. 

The SCSI interface can be used with 
hard disk drives of up to SOMb that have 
SCSI interfaces. The SCSI bus can also be 
connected to other SCSI interface devices 
(e.g., laboratory instruments). 

Software is provided to operate the mo- 
dem under the Z-System DOS and for 
integrating hard disk drivers. 

The board may be purchased with only 
the modem or SCSI components with up- 
grade later. Prices start at $150. Call 
(800) 635-3355 to order. Call (203) 871- 
6170 for technical information, or write to 
Micromint Inc., 25 Terrace Dr., Vernon, 
CT 06066. 


19.2K-BPS COMPACT LINE DRIVER 
The Prentice DLD is a line driver which 
allows asynchronous devices to communi- 
cate at up to 19.2-bps for up to 3 miles. 
Twisted-pair and male or female DTE or 
DCE interfaces permit connections to 
standard terminals, multiplexers or data 
switches. The Telco line interface can be 
either standard RJ11 jack or four-position 
terminal board. DLD conforms to Bell 
43401 up to 9600-bps, and meets CCITT 
V.24/V.28 recommendations. 

Cost is $84 each in packs of ten. Con- 
tact Prentice Corp., 266 Caspian Dr., Box 
3544, Sunnyvale, CA 94088, (408) 734- 
9810. 


68020 SINGLE BOARD COMPUTER 

The GMX Micro-20 is a single 8.8 X 5.75- 
inch board computer that combines 12.5 or 
16.67 Mhz 68020 microprocessor and op- 
tional 68881 floating-point processor with 
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2Mb of 32-bit wide RAM, up to 256K of 
32-bit wide EPROM, four serial ports, par- 
allel port, 5%-inch floppy disk controller, 
SASI peripheral interface, time-of-day 
clock with battery backup, and a 16-bit ex- 
pansion connector. Included is a version of 
Motorola’s 020Bug monitor/debugger and 
hardware diagnostics in PROM. Options 
include Unix-style operating systems, 1/O 
expansion boards, color graphics interface, 
cabinet, power supply, and disk drives. 
Cost for the 12.5 Mhz version is $2750. 
Contact GMX Ince., 1337 W. 37th Place, 
Chicago, IL 60609, (312) 927-5510. 


GRAPHICS 


w.A versus US 


HITACHI 64180 IN-CIRCUIT 
EMULATOR 

The Softaid ICEBOX is an in-circuit emu- 
lator for Hitachi 64180 systems. It pro- 
vides full-speed, real-time emulation. 
Built-in automatic tests allow it to isolate 
problems. A software package is included 
to automate test and repair operations. It 
is transparent to the target system and 
does not alter the system. 

ICEBOX performs the following func- 
tions: downloads hex and binary files, tests 
all target system RAM and computes 
ROM checksums, exercises all I/O ports 
and memory addresses, finds software 
faults in ROM and RAM, traces program 
execution, and provides MMU remap. Is 
supports true hardware transient and per- 
manent breakpoints. 

Cost is $1200. Contact Softaid Inc., 
Box 2412, Columbia, MD 21045, (301) 
792-8096. § 
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SCI-GRAF: Produces line, scatter, and 
high/low plots on Epson or IBM com- 
patible dot-matrix graphics printers. 
Supports images up to 1680x1712 dots 
(over 3 million pixels!), log & linear 
scales, graphs in 7 colors (on a JX-80), 
batch processing. 

Requires MS-DOS 2 or 3, 256k . ..$99°5 


ame MSC 


FONTEDIT: Easy-to-use full screen font 
editor allows you to create and modify 
fonts for our SCI-GRAF program. Create 
Greek, math, and custom symbols in 3 
sizes. Supports SCI-GRAF’s propor- 
tional spacing. Requires IBM compati- 
ble 320x200 pixel on-screen graphics & 
IBM compatible keyboard 


Microcomputer 
Systems 
Consultants 


GRAF 3.0: Produces bar, pie, line, scatter, 
and high/low plots on Epson, IBM, 
C.toh, or NEC compatible dot-matrix 
graphics printers. Supports 14 fill-in patt- 
erns, 8 point-plotting symbols, automatic 
scaling, labeling, and legend creation. 

MS-DOS 2 or 3, 192k .......-0006 $6995 
CP/M-80: Requires 64k (54k TPA) 349% 


32 W. Anadamu St. Ste. 190 Santa Barbara, CA 93101 805-963-3412 


87 


THE SOFTWARE DIRECTORY 


When contacting software publishers 
please mention that you read about their 
product in Micro/Systems Journal. 


Program Name: Poly Boost 

Requirements: PC/XT/AT or compatible 
Description: A set of three memory-resident 
programs that speeds up disk access (via a 
disk cache), screen display (via direct 
screen writes), and keyboard input (via a 
typeahead buffer). The program is com- 
patible with a variety of hardware and 
software. 

Price: $79.95 (60-day, money-back 
guarantee) 

Publisher: Polytron Corp., 815 NW 169th 
Pl., Ste. 2110, Beaverton, OR 97006, 
(503) 645-1150. 


Program Name: Power Tools 

Requirements: PC compatible with 256K 
RAM 

Description: A memory-resident hard-disk 
utility. Can locate a file in any directory, 
access programs located in other directo- 
ries, “defragment” files, format a diskette 
while running another program, and exe- 
cute DOS commands while running pro- 
grams. Can copy or move files or 
subdirectories; view, edit or print any file 
or sector; locate any file or string on a disk; 
map disk usage; and restore erased data. 
Price: $50 

Publisher: MLI Microsystems, Box 825, 
Framingham, MA 01701, (617) 926-2055. 


Program Name: Attach 
Requirements: TurboDOS System 


Description: Enables TurboDOS users using 


any processor to attach their processors to 
any other processor on the same network. 
Can work between any two TurboDOS 
processors independent of the master/ 
slave assignment. Extends TurboDOS ca- 
pabilities by excluding multiple slaves 
from attaching themselves to the master 
processor. Allows collection of console 
outputs into a file for later review. 

Price: $150 

Publisher: InterContinental Microsystems, 
4015 Leaverton Ct., Anaheim, CA 92807, 
(714) 630-3714. 


Program Name: GTP Development System, 
Version 2 

Requirements: PC or true compatible, 256K 
RAM, Turbo Pascal V3.0, and two disk 
drives 

Description: An application generator pro- 
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ducing error-free Turbo Pascal code for 
screen and database systems. Can create 
multiple screens, and allows database up- 
date and retrieval, automatic field edits, 
memory-mapped video, color, calcula- 
tions, error handling, and context-sensitive 
help. Database manager uses a hashed 
attribute index scheme that automatically 
builds and maintains an index for each 
field. Global search supports wild cards 
and phonetics. Has a report generator and 
a menu generator for bundling applica- 
tions together. 

Price: $150 

Publisher: Allen, Emerson & Franklin, 
Inc., Box 928, Katy, TX 77492, (713) 
391-8570. 


Program Name: C-Index 

Requirements: Lattice C Compiler, Com- 
puter Innovations C86, Microsoft 3.0, 
Consulair, UNIX/XENIX System V, Wiz- 
ard, Manx Aztec, and Mark Williams. 
Description: A data-management tool for C 
programmers. Provides full B+Tree in- 
dexing. Available in three versions: (1) C- 
Index/Files—includes object code and 
supports multikey routines for automatic 
memory management; (2) C-Index /Pro— 
includes both object and source code; 
applications can be distributed without 
royalty; (3) C-Index/Plus—includes 


transportable source code, no royalty, and | / 


telephone support. 

Price: Evaluation, $25; C-Index/File, $99; 
C-Index/Pro, $195; C-Index/Plus, $395. 
Publisher: Trio Systems, 2210 Wilshire 
Blvd, Ste. 289, Santa Monica, CA 90403, 
(213) 394-0796. 


MEGABASIC 
IS FOR SERIOUS SOFTWARE 
DEVELOPMENT. 
30 DAY FULL REFUND 
SATISFACTION GUARANTEE 
PRICE: $395.00 


+ Full memory utilization (e.g. 500k arrays). 

* 32 Bit. integers, up to 18 digit floating point. 

+ Extensive string processing (including 
large strings). 

+ Add your own language feature with 
ADA-like packages. 

* Many features found in no other BASIC 
(e.g. vector processing). 

* Fast execution and program 
development. 

* Network support (3com, Novell, IBM-NET, 
PC-NET, VIA-NET). 

+ Runs under PC DOS, XENIX, 
CONCURRENT / MPM, PCPRO, Turbodos. 


For more information call or 
write 
( omputer House, Inc. 
P.O. Box 709 Woedacre, CA 
94973 
(415)453-0865 


Program Name: CSharp 

Requirements: PC/XT/AT or compatible 
and a C compiler (Microsoft, Lattice, 
Computer Innovations C-86, or Rational 
Systems Instant-C) 

Description: A C library of support routines 
for data acquisition and control of hard- 
ware. Supports the Metrabyte Dash 8/16 
and Data Translation DT2801 /2808 analog 
1/O boards, National Instruments’ GPIB- 
PC IEEE488 interface card, and Keithly 
Series 500 system. 

Price: $195 (limited to 25 units): $975 (un- 
limited units). 

Publisher: Systems Guild, PO. Box 1085, 
Kendall Square Station, Cambridge, MA 
02142, (617) 451-8479. § 
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d/MULTI 


MUL 


USER dBASE 
for 
TurboDOS 


TRUE File and Record Locking as easy as 
d-BASE-I. Unlimited users can perform the 
magic of dBASE in the program or 
interactive mode 


* TurboDOS 1.3 or 1.4 
* No Peeks or Pokes 


* System Date and Time Functions 
* Printspooler Controls up to 16 printers 


Martian Technologies... 
-CREATEing Multi-users from 
Single-users around the world 


CALL FOR DETAILS ( 


Martian Technologies 
8348 Center Dr., Ste.-F, La Mesa, CA 92041 
(619) 464-2924 


) 
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Title Author Vol-No 
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Assembly Language 

Structured Programming With M80 Dennis Quinn 1-3-26 

BASIC Language 

Assembly Language Extensions for 

Microsoft BASIC Ron Kreymborg 1-1-36 

Control Systems Made Simple Lynwood Wilson —2-5-20 

C Language 

C Forum (Variable Size Arrays) | Don Libes 1-1-18 

C Forum (Writing a Translation 

Program) Don Libes 1-2-16 

C Forum (Sets & Bit Operations) Don Libes 1-3-22 

C Forum (1986 Obfuscated C Code 

Contest) : Don Libes 1-4-14 

C Forum (Context-independent 

Macros) Don Libes 1-5-16 

C Forum (C Interpreters) Don Libes 2-1-16 

C Forum (getopt-a subroutine for 

parsing command-line arguments) Don Libes 2-2-16 

C Forum (International Obfuscated 

C Code Contest) Don Libes 2-3-10 

C Forum (Casts) Don Libes 2-4-8 

C Forum (Reading Input) Don Libes 2-5-16 

C Forum (Keeping Track of 

malloc( )) Don Libes 2-6-20 

C and Godbout Disk Controller Ed Heyman 1-2-46 


C Interpreters—Review D Libes & G Morris 2-2-22 


C Source-Level Debuggers— 


Review Jonathan Sachs 2-2-28 
Declare & Define C Variables In 

One File Bill Rogers 2-4-66 
Declare & Define C Variables In 

One File Ed Fields 2-6-10 
Faster Floating Point Math N.T. Carnevale 1-5-46 
Concurrent DOS (CCP/M) 

Concurrent-CP/M Print Utility Alex Soya 1-4-30 
Concurrent-DOS (Part I—Features, 

Architecture & Common 

Problems) Alex Soya 2-3-44 
Concurrent-DOS (Part II— 

Processes & Their Data Structures) Alex Soya 2-6-56 
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CP/M 

Add A RAM disk To A CP/M 

System Howard Peters 2-3-66 
Bringing Up CP/M-68K J Calaway & B Hill 1-5-58 
Bringing Up CP/M Plus Sheldon Kolansky —_1-1-20 
CP/M Bus (Public Domain Hit 

Parade) Bruce Ratoff 1-2-75 
CP/M Bus (SB-180, DateStamper, 

Ztime-1 Z80ASM & DSD80 

reviewed) Bob Blum 2-2-70 
CP/M Bus (Patchs for Submit & 

Zsid) Bob Blum 2-4-44 
Enhancing CP/M-80 William Dudley 2-5-28 
Extended Single-Density Disk 

Storage Willis Howard 1-1-30 
Loadable BIOS Drivers For CP/M Cal Sondgeroth 1-2-66 
More Loadable BIOS Drivers For 

CP/M Ted Carnevale 2-4-72 
New Tricks for CP/M2.2: Logical 

Name Translation David Brewer 1-1-46 
Syslib, Z3lib & Vlib Richard Conn 2-5-72 
Transfer Files Between CP/M & 

MS-DOS Hank Volpe 2-1-66 
ZCPR3 & How to Install It Randy Reitz -42 
Communications 

Setting Up An RCP/M System Bob Blum 2-3-74 
Data Base Forum 

dBASE-II Speed Techniques—Part I Nelson Dinnerstein — 1-5-28 
dBASE-II Speed Techniques—Part II Nelson Dinnerstein 2-1-82 
dBASE-III Developer’s Release Nelson Dinnerstein 2-2-74 
More dBASE-II Speed Techniques Nelson Dinnerstein —_2-3-82 
Forth Language 

Local Variables Thomas Reno 1-3-38 


Hardware (General) 

First Look At 80386 
Interfacing Using SCSI Bus 
Scientific Work Stations 


Hardware—PC/XT & Compatibles 
Building an IBM-PC/XT clone 


Build An S-100 to PC Bus Converter 


Roll Your Own PC Clone—Part I 
Roll Your Own PC/XT/AT Clone 


Roll Your Own PC Clone—Part II 


The PC Bus 

Turbocharge Your 8086/8088 
Computer—Part I 
Turbocharge Your 8086/8088 
Computer—Part II 
Assembling An AT Clone 
Converting From CP/M To 
MS/DOS On The PC 

Building An AT Clone 

Power To The PC! 

Experiences Of PC Clone Dealer 
Speeding Up The PC/XT 


Michael Weinreich 2-5-34 


Hul Tytus 2-5-46 

A.G. Cameron 1-5-76 
Hank Kee 1-1-74 
John Monahan _ 1-2-24 
Sol Libes 1-2-36 
Sol Libes 2-2-66 
Sol Libes 2-6-24 
Dave Hardy 1-3-79 
Stephen Davis 1-5-32 
Stephen Davis 2-1-32 
Sol Libes 2-1-44 
Robert Stek -2- 


2 
Leon Suchard 2 
Stuart Jones 2 
Al Levy 2 
Doug Severson 2 
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Cloning In Fast Lane (Review: PC’s 


Limited 12-Mhz AT Clone) 
Hardware—S-100 


Build An S-100 to PC Bus Converter John Monahan 


Build An S-100 EPROM Emulator 


Build An S-100 HD64180 CPU Card Roger Stevens 


Build A Smart Keyboard Interface 
C and Godbout Disk Controller 
Macrotech MI-286 Review 

Peak 68K8-CP Review 


Sol Libes 2-6-42 
1-2-24 
Robert Rioja 2-1-60 
2-3-28 
John Monahan 2-4-34 
Ed Heyman 1-2-46 
Charles Strom 1-3-48 


D Hardy & K Jackson 1-5-66 
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Upgrading CompuPro I/O Boards 


Hardware (Product Reviews) 

Baby Blue 

CompuPro 10 Plus 

CompuPro S-100 PC Video Board 
Earth Computer Turboslave-PC 
Holliston Challenger XT-186 
Lomas Data Products’ S100-PC 
Macrotech MI-286 


R.K. Gerson 


Robert Stek 


Michael Guttman 


Alex Soya 
Robert Stek 
Charles Strom 


D Hardy & K Jackson 


Charles Strom 


Magnum Digital PRO-180 & FD-100 Steven Kapplin 


PC’s Limited 12Mhz AT Clone 
Peak 68K8-CP 
Slicer 80186 


Lisp Language 

16-Bit Lisp & Prolog 
Implementations—Part I 
16-Bit Lisp & Prolog 
Implementations—Part II 


Pascal Language 

Interrupt Borrowing With Turbo 
Pascal 

Intersystem Processing 

Turbo Pascal Corner (writing a 
translation program) 


Turbo Pascal Corner (handling data 


translations) 

Turbo Pascal Corner (the TYPED 
constant) 

Turbo Pascal Corner (advanced 


Sol Libes 


D Hardy & K Jackson 


William Earnest 


William Wong 


William Wong 


Stephen Davis 
Hank Volpe 


David Carroll 
David Carroll 


David Carroll 


machine-level interfacing techniques) David Carroll 


Turbo Pascal Corner (support & 
Enhancement products) 
Turbo Pascal Corner (Sorting) 


Turbo Pascal Corner (Public Domain 


Utilities) 

Turbo Pascal Corner (Hi Speed 
Screen Output) 

Turbo Pascal V3.0 


MS/PC-DOS 
Configuring MS-DOS 


Creating A Copy Protected Program 
Implementing PC-DOS On Non-IBM 


Compatible Computers—Part I 


Implementing PC-DOS On Non-IBM 


Compatible Computers—Part II 
Interfacing to MS-DOS 


Part-I The Program Segment Prefix, 


Access to DOS, and How to 
Terminate A Program 

Part-II Dealing With Character 
Input & Output Functions 


Part-III Basic File Access Functions 


Part-IV Basic File Access 
Part-V Programming MS-DOS 


Part-VI Device Drives—Why and 


How 


Part-VII Device Drives—Structures 


Part-VIII Memory Disk Device 
Driver 

Part-IX Printer Device Driver 

Part-X Why Move to DOS 3.X? 
Recovering PC-DOS Files 
Using SYMDEB With NMI 
Breakpoints 


Software—Public Domain 
CP/M Bus (Public Domain Hit 


David Carroll 
David Carroll 


Stephen Davis 
Stephen Davis 
David Carroll 


Sol Libes 
Edwin Thall 


C Cochran & K Sweger 


C Cochran & K Sweger 


William Wong 


William Wong 
William Wong 
William Wong 
William Wong 


William Wong 
William Wong 


William Wong 
William Wong 
William Wong 
Edwin Thall 


James Owen 


1-4-42 


2-2-80 
1-4-48 
2-2-60 
2-2-80 
2-4-52 
2-2-58 
1-3-48 
2-4-62 
2-6-42 
1-5-66 
1-3-56 


1-1-62 


1-2-56 


i-4-34 
2-1-66 


1-2-20 
1-3-18 
1-4-20 
1-5-12 


2-1-18 
2-3-20 


2-5-14 
2-6-14 
1-275 
2-3-38 
2-4-28 
2-1-26 


2-2-38 


1-2-32 


1-3-62 
1-4-54 
1-5-70 
2-1-38 


2-2-50 
2-3-40 


2-4-54 
2-5-62 
2-6-44 
2-6-6 


2-5-66 


Parade) 

SIG/M Volumes 210-217 
SIG/M Volumes 218-223 
SIG/M Volumes 224-227 
SIG/M Volumes 228-231 
SIG/M Volumes 232-241 
SIG/M Volumes 242-246 
SIG/M Volumes 247-251 


SIG/M Volumes 252-264 & 800-801 


SIG/M Volumes 265-271 
SIG/M Volumes 272-281 
SIG/M Volumes 282-287 
SIG/M & PC/Blue Distribution 
Points 

PC-Blue Volumes 100-100 
PC-Blue Volumes 111-114 
PC-Blue Volumes 117-124 
PC-Blue Volumes 125-137 
PC-Blue Volumes 138-147 
PC-Blue Volumes 148-160 
PC-Blue Volumes 161-175 
PC-Blue Volumes 176-187 
PC-Blue Volumes 188-200 
PC-Blue Volumes 201-220 
PC-Blue Volumes 221-237 


Software (Product Reviews) 

C Interpreters 

C Source-Level Debuggers 
C/nix Update 

CompuMagic Utility Package 
Concurrent PC-DOS 

ConIX & ConIX Tools 
CP/Emulator II 

dataCURE 

dBASE III 


DSD80 (CP/M full-screen debugger) 


Echelon’s Z-System 
Eureka 

FirstTime for C & Turbo Pascal 
Fontedit 

Hochstrasser’s Modula-2 
16-Bit Lisp & Prolog 
Implementations—Part I 
16-Bit Lisp & Prolog 
Implementations—Part II 
MathCAD 

MathCAD 

Mex-PC 

PC-Pro (PC-DOS on CompuPro) 
Phoenix’ PFIX-Plus Debugger 
Plotz Graphics 
Plu*Perfect DateStamper 
PMate 

Ratfor 

Reflex 

Ryan-McFarland Fortran 
Scientific/Technical Word 
Processors—Part I 
Scientific/Technical Word 
Processors—Part II 
SciPlot 

SCI-Graph 

TEX 

Turbo Pascal V3.0 
TurboDOS/PC 

Watcom 

Watfor-77 

Xpip 


Bruce Ratoff 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 
Stephen Leon 


Bob Todd 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 
Hank Kee 


D Libes & G Morris 
Jonathan Sachs 
R.A. Langevin 
Joseph Sabin 


M Guttman & V Mills 


Steven Kapplin 
Robert Stek 
Bruce Ratoff 
Scott Patashnick 
Robert Blum 
Morris Simon 
Robert Hazelwood 
Stephen Davis 
A.G. Cameron 
Edward Joyce 


William Wong 


William Wong 
Avram Tetewsky 
A.G. Cameron 
Dennis Quinn 
Alex Soya 
Stephen Davis 
A.G. Cameron 
Gord Wiggins 
A.G. Cameron 
A.G. Cameron 
Nelson Dinnerstein 
A.G. Cameron 


Steven Bosak 


Steven Bosak 
A.G. Cameron 
A.G. Cameron 
A.G. Cameron 
David Carroll 


M Guttman & V Mills 


A.G. Cameron 
A.G. Cameron 
Edward Joyce 


2-2-22 
2-2-28 
1-3-59 
2-5-80 
1-3-66 
2-3-56 
2-2-81 
1-1-68 
1-1-56 
2-6-83 
2-6-72 
1-5-86 
2-3-60 
2-6-50 
2-4-70 


1-1-62 


1-2-56 
2-6-53 
2-6-50 
2-3-52 
2-5-38 
2-4-48 
2-6-50 
2-5-84 
2-4-80 
2-6-50 
2-4-88 
2-4-80 


1-3-40 


2-1-50 
2-4-80 
2-6-50 
1-4-64 
1-3-72 
2-1-42 
2-4-80 
2-4-80 
2-4-84 
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Software Directory SciPlot Graphics Library 2-2-86 


CP/M Software SMK-Seidl Make Utility 2-5-9] 
Able One Mailing List 2-2-87 Snobol4+ 1-5-90 
DSD80 1-3-54 Techtype 2-6-94 
Electra-Find 1-3-54 Tutori/o 2-5-91 
Jontel Business System 2-2-87 TurboDos 

Locipro 1-5-90 d/Multi 1-5-90 
Masterforth 1-4-82 Xenix 

MB-+ Tools 1-5-90 XPD 1-4-82 
Megaback 2-6-94 

Modem Mail 2-5-9 1 TEX 

MTBASIC*ROM 2-2-86 TEX review A.G. Cameron 1-4-64 
Pluto Basic 1-4-82 TEX developments, Printer Drivers, 

R/Doc-X 2-2-86 Screen Preview and Postscript A.G. Cameron 2-2-78 
Revas4 1-5-90 Metafont A.G. Cameron 2-4-83 
Smarts 1-5-90 

Snobol4+ 1-5-90 UNIX 

Write-Hand Main 1-4-82 Coherent System review Les Hancock 1-3-74 
ZAS 1-5-90 Unix File Ian Darwin 1-2-73 
ZDM 1-5-90 Unix File (mailing list system & 

MS/PC-DOS Software Formatting C programs) Ian Darwin 1-3-8] 
db Vista V2 1-5-90 Unix File (macro processing & 

DSD86 & DSD87 2-5-91 Getting On the Unix Net) Ian Darwin 1-4-76 
F77L 1-4-82 Unix File (Hacker’s OS & Tuning 

Instant C 1-3-54 Unix Programs) Ian Darwin 1-5-84 
Invisible Optimizer 2-6-94 Unix File (Public Domain Software 

Locipro 1-5-90 & Join) Ian Darwin 2-1-78 
Lattic Topview 2-5-91 Unix File (Usenet & Join) Ian Darwin 2-2-72 
Masterforth 1-4-82 Unix File (Command Portability) | Ian Darwin 2-3-88 
Matrix 100 1-5-90 Unix File (Unix Books) Ian Darwin 2-4-68 
MB-+ Tools 1-5-90 Unix File (MH Mail Handler) Tan Darwin 2-5-88 
MPS 2-5-91 Unix File (Unix Internals, Binary 

MT8087 Basic Compiler 2-2-86 Files & Termcap Entries) Ian Darwin 2-6-86 
PC-Lint 2-5-91 

Periscope II-X 2-6-94 ZCPR 

Pluto Basic 1-4-82 CP/M Bus (Patchs for Submit & 

QROFF 2-2-87 Zsid) Bob Blum 2-4-44 
R/Doc-X 2-2-80 Echelon’s Z-System Morris Simon 2-6-72 
RPG-II 2-5-91 Syslib, Z3lib & Vlib Richard Conn 2-5-72 
RTC (Ratfor-to-C translator) 2-6-94 ZCPR3 & How to Install It Randy Reitz 1-2-42 § 


DYNA-MITE v4.0 


Terminal Emulation Software with File Transfer for DOS Machines 
latest generation of the classic MITE datacomm package, just $99.95! 


XMODEM, XMODEM/Batch, YMODEM, Kermit, MITE and other Protocols 
Duplicate "menu" and "command" style control mechanisms 

Emulation of VT19#@, VT52, TV925, ADDS VP, ADM3a, Z19, IBM3191, others 
MORSE programming language with variables, cond. branching, etc 
Lower priced versions (with fewer features) available (incl. CP/M-8@) 


Mycroft Labs, Inc. / P.O. Box 4106 / Tallahassee FL 32315 
Phone: 904 385-1141 Orders: 1800 MYCROFT 8BS: 904 385-MITE 
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a | 


Micro/Systems Journal accepts Classified 
Ads. The charge is $6/line (3 lines minimum); 
40 characters max./line. Three times frequency 


COMPUTER PROFESSIONALS 

with good writing skills to evaluate & review 
latest computer software products for national 
sydication. Part/time, contract stringer. Must 
have access to DEC, IBM PC, MAC or com- 
patible clones. Send resume: PSPA, 830 Bay 
Ave., #G Dept 7, Capitola, CA 95010 


MS-DOS Shareware 
$3.00 each disk postpaid. 000 catalog on disk, 
001 expert system, 007 X-lisp, 014 B&W games, 
015 color games, SMUG, 39 Hanover St., Ashe- 
ville, NC, 28806-4158. 63x 


FOR SALE: PMMI S100 Modems, FCC reg- 
istered, Professionally Maintained, Tested and 
Guaranteed 90 days private use. 300/600 Baud. 
SALE $49.95 + P&H. Prepaid orders from 
stock, Checks allow 2 weeks. Sorry No CC. 
Order PMMI/103MS, Send $54.45 to: Sparks 
Micro, Box 880, Sparks, MD 21152 (301)472- 
4880 S100 Specialists Since 1978. 


V6/2x 


$15/line; six times $25; non-profit clubs $2/ 
line. Logos, special type, etc. are extra charge. 
Check must accompany ad copy. Send to M&T 


FOR SALE: COMPUPRO dual 1.2 MB flop- 
py disk subsys, DISK 1, DT-8 Qume’s, cables, 
encl, CPM80. Like new, orig $1750, ask $900/ 
offer. IDS, IP-225 dot matrix printer w/graphics, 
parallel port, w/3P+S board, 160 cps, $250/ 
offer. Bob Miller 408-371-2677 


2/6/3x 


JONTEL BUSINESS SYSTEM 


The Jontel Business System is a five journal 
accounting package based on a dual disk CP/M 
computer. Included with the seven disk package 
are mailing and inventory programs with 100+ 
pages of documentation on disk. 8” & 5” disk 
formats available. $69.95. Moonlite Computer, 
707 Edge Hill Rd., New Bern, N.C. 28560. 
Source code available for custom installations, 
compiled CB80. (919)638-6976. 


FOR SALE: New Fulcrum Omnidisk con- 
troller with CP/M, $195. Gary Van Cott, Box 
1879, Grafton VA. 804-898-3680. 


VO6/3x 


Publishing, Inc., 501 Galveston Dr., Redwood City, 
CA 94063 


FOR SALE: CompuPro 20 slot S-100 
enclosure/motherboard, Paradynamics model 
2200D dual 8” enclosure, 2 Mitsubishi model 
M2894-63 8” drives, Advanced Digital 4MHz 
Z-80 SBC, US Robotics S-100 1200B modem, 
ADDS model VWPNT terminal, Comrex CR-1 
Daiseywheel printer, CP/M 2.2 and SCP/80 front 
end, Pascal MT + and Aztec C compilers, 100 8” 
disks, 2 8" flip’n’files. Running system, used 
< 200 hrs. Package = $2000. W, 804-253- 
4006; H, 804-693-5897. 


CompuPro System FOR SALE: Near-new 
home system, CPU-Z, RAM16, DISK1, INTER- 
FACER 4, CCS 12 slot mainframe, 2 Mit 
M2896-63 half-ht 8” drives, Tel 510+ term, 
software + CP/M. Present new value: $2780. 
Sell for $1795 + UPS. 703-463-6793. 


CP/M Software. Choose from 400 Public Do- 


main volumes. 100 page catalog $7.50. New 
CP/M 2.2 Digital Research Manual $19.95 + 
$3.00 S&H. Send SASE for Flyer. ELLIAM 
ASSOCIATES, 6101 Kentland Avenue, Suit M, 
Woodland Hills, Ca 19367 


2/4/2x 


BUSINESS BOARD 


24 hour business information center using 
modems at 399/1288/2498 baud. Has a multi- 
level menu system that is easily customized 
with no programming req’d. Includes remote 
PC operations and integrated data base 
management. Source code additional charge. 


COMMX 


Emulates VT19%,Wyse,HP,ADM, TV, IBM, ADDS, file 
transfers: KERMIT, XMODEM, COMMX mainframe, 
Telex/TWX. Instant DOS/foreground switch! 
Unattended macro controls and 7@@ entry 


dial directory. Electronic mail sub-system! 


sso C DATA ENCRYPTION 


Data government 
standard FIPS PUB46) in Microsoft "C". 
Includes compression & telecomm formatting, 
allowing for faster transmission & storage 
on any computer or service. Complete "C" 
source code provided for additional $249. 

Wet, HAWKEYE Box 146%, Oldsmar 

(A) GRAFIX Inc Florida 33557 

a ladl Call 813-786-8161 


$99 


RP/M2™ creates 


Z80® 


CP/M°©2.2 compatible 


IBM PC 


Now available for Decmation’s Blue Thunder softcard, PC 
RP/M2 is an operating system. Either standalone or with 
DOS present, PC RP/M2 provides the solid base of a genuine 
operating system reliably distinct from the facade created by 
an MSDOS interface. All 2.2 system and CBIOS calls are 
supported, with 56.5k TPA, file date and time stamping, fast 
virtual disk, iobyte redirection, terminal emulation, color 
console display, auto relog, COM path, addressable SAVE, 
single key phrase recall. SETDISK redefines a drive to any of 
over 80 CP/M formats. DOSDISK invokes built-in access to 
DOS drives. System disk with manual $129. Blue Thunder™ 
softcard $149. Shipping $5 ($10 nonUS) EE G@®& 


A 


Kise 
ethods, 
| 


$99 PC $119 CP/M 


Encryption Standard (U.S. 


118 SW First St. - Box G 
Warrenton, OR 97146 
(503)861-1765 


oe 
Inc. 
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gees Micro/Systems Journal, Back Issues am 


The following back issues are available at $5.00 for | issue, $4.50 each for 2-5 issues and $4.00 for 6 or more issues. Send orders with payment 
to M&T Publishing, 501 Galveston Drive, Redwood City, CA 94063. Credit card orders may be placed by calling 415-366-3600, ext. 216. 


MARCH/APRIL 1985 (Vol. 1, No. 1): Bringing up CP/M Plus, Assembly Language 
Extensions for MS-Basic, New Tricks for CP/M2.2, Building an IBM/PC or XT 
Clone, Extended Single Density Storage, Variable Size Arrays in C; REVIEWS: 
dBase-III and 16-Bit Lisp & ProLog-Part I. 


MAY/JUNE 1985 (Vol. 1, No. 2): Build an $-100 to PC-Bus Converter, interfacing 
to MS-DOS Part-I, Loadable Drivers fo CP/M2.2, Roll Your Own PC-Clone, 
Bringing up ZCPR-3, C & Godbout Disk-1 Controller, Writing Translation Pro- 
grams in C and Turbo Paszal; REVIEWS: 16-Bit Lisp & Prolog-Part II. 


JULY/AUGUST 1985 (Vol. 1, No. 3): Structured Programming With Microsoft 
M80 Assembler, Local Variables in Forth, Interfacing to MS-DOS Part-Il, Data 
Translation with Turbo Pascal, Implementing Sets with Bit Operations in C, A Unix 
Mail List System; REVIEWS: Scientific & Technical Word Processors-Part I, 


JANUARY/FEBRUARY 1986 (Vol. 2, No. 1): Implement PC-DOS on Non-IBM 
Compatible Computers, Part-1; TurboCharge Your 8086/8088 Computer, Part-II; 
Assembling An AT Clone; Build An $-100 EPROM Emulator, Transferring Files 
Between CP/M and MS-DOS Systems; Program Interfacing to MS-DOS Part V; 
dBase-II Speed Techniques; Unix Public Domain Software; REVIEWS: Scientific 
Word Processors-Part II; Turbo-DOS PC; Turbo Pascal Support & Enhancement. 


MARCH/APRIL 1986 (Vol. 2, No. 2): Implementing PC-DOS On Non-IBM Com- 
patible System Part-II (Conclusion), Program Interfacing TO MS-DOS Part-VI, 
Rolling Your Own PC/XT/AT Clone, Converting From CP/M To MS-DOS On 
The PC, A C Subroutine For Parsing Command-Line Arguments, Arithmetic Aber- 
rations With dBase-III and the dBase Developer’s Release, The Marriage of TEX and 
Postscript; REVIEWS: C Interpreters, C Source-Level Debuggers, Lomas Data 
Products’ $-100 PC, CompuPro S-100 PC Video Board. 


Macrotech MI-286 S-100 CPU Card, Slicer System, Concurrent PC-DOS, Coherent 


Operating System. 


SEPTEMBER /OCTOBER 1985 (Vol. 1, No. 4): Who Prints on Printer with CCP/M 

Interrupt Borrowing with Turbo Pascal, Upgrading CompuPro I/O Boards, 
Program Interfacing to MS-DOS Part-II, SIG/M & PC/Blue Public Domain Soft- 
ware Distribution Points, TurboDos INSTALL program; REVIEWS: CompuPro 
10+, TEX. 


NOVEMBER/DECEMBER 1985 (Vol. 1, No. 5): TurboCharge Your 8086/8088 
Computer, Faster Floating Point Math with C, Bringing up CP/M-86K, Program 
Interfacing To MS-DOS Part-IV, advanced Machine Level Interface Techniques For 
Turbo Pascal, Context-Independent Macros for C, Build Your Own PC Program 
Library Using Public Domain Software, dBase-II Speed Techniques-Part I, Tuning 
Unix Program; REVIEWS: Peak 68K8-CP, Eureka For CP/M-80, Scientific Work- 
stations. 


MAY/JUNE 1986 (Vol. 2, No. 3): Build An S-100 HD64180 CPU Card, Configur- 
ing MS-DOS, Writing MS-DOS Device Drivers (Part 2), Building An AT Clone, 
Adding A RAM Disk To A CP/M System, Obfuscated C Code Contest, Sorting 
With Turbo Pascal, More dBase Speed Techniques, Using an RCPM System; RE- 
VIEWS: Concurrent DOS, MEX-PC, ConIX, FirsTime. 


JULY /AUGUST 1986 (Vol 2., No. 4): Power to the PC, Creating A Copy Protected 
Program, Build Smart Keyboard Interface, Writing An MS-Dos Memory Disk De- 
vice Driver, Declare & Define C Variables in One File, More Loadable BIOS Drivers 
For CP/M; REVIEWS: Phoenix’ PFIX-Plus Debugger, Holliston Challenger 

XT 186, Magnum Digital PRO-180 & FD-100, XPIP, PMATE, Ryan-McFarland For- 
tran, WAT-COM, Watfor-77, MicroGlyph SciPlot, Softech Matrix Calculator, 
Personal TEX. 


SEPTEMBER/OCTOBER 1986 (Vol. 2, No. 5): Control Systems Made Simple; 


Enhancing CP/M-80; A First Look At the 80386; Interfacing Using the SCSI Bus; 
Program Interfacing To MS-DOS—Part 1X; Using SYMDEB With NMI Break- 
points, SYSLIB, Z3LIB & VLIB; REVIEWS: PC-Pro; CompuMagic Utility Package; 


Plu*Perfect Systems’ DataStumper. 


Here’s why you should choose Periscope as your debugger... 


You'll get your programs running fast. “It works 
great! A problem we had for three weeks was 
solved in three hours,” writes Wade Clark of 
MPPi, Ltd. 


You'll make your programs solid. David Nanian 
says, “I can’t live without it!! BRIEF, a text 
editor my company wrote, would not be as stable 
as it is today without Periscope.” 


You'll protect your investment. We won't forget 
you after the sale. You'll get regular software 
updates, including a FREE first update and 
notice of later updates. You'll get technical help 
from Periscope’s author. And you'll be able to 
upgrade to more powerful models of Periscope if 
you need to. One Periscope user writes, “.. . 


your support has won over even the heart of this 
hardened programmer!” 


You deserve the best. Thousands of programmers 
rely on the only debugger that PC Tech Journal 
has ever selected as Product of the Month 
(1/86). You owe it to yourself to find out why, 
first hand. 


You can try it at no risk. You get an uncondi- 
tional 30-Day, Money-Back Guarantee, so you 
can’t lose. 


Start saving time and money now — order toll- 
free, 800/722-7006. Use MasterCard, Visa, 
COD, or a qualified company purchase order. As 
one user puts it, Periscope is “one of the rare 
products, worth every penny!” 


Periscope I, software, manual, 
protected memory board and 


breakout switch ..................... $295 
Periscope II, software, manual, and 
breakout switch ..................... $145 


Periscope II-X, 
software and manual ............... $115 
Add shipping - $3 US; $8 Canada; $24 elsewhere. 
Ask about air shipment if you can’t wait to get 
your programs up and running! 


| 
PERISGOPE 


The Periscope Company, Inc. 
(formerly Data Base Decisions) 
14 Bonnie Lane, Atlanta, GA 30328 404/256-3860 
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CP/M 


. Dobb's 
bit Toolbook 


Dr. Dobb's Z80 Toolbook ¢ 
Item #022 $25.00 ¢ 
This book and its companion disk 
contain everything you need to write 
your own Z80 assembly language pro- 
grams. You'll find a method of designing 
programs and coding them in assembly 
language, and a complete integrated toolkit 
of subroutines. 

280 Toolbook with software 
ondisk Item#022A $40.00 


Formats: 8" SS/SD, Apple, Osborne, Kaypro 


«Programmer's Guide to CP/M Item#219 $14.95 
Edited by Sol Libes, this is a collection of all CP/M articles 
in Micro/Systems magazine from January 1980 through 
February 1982. 


BASIC Programmers 


Basic Booster Library Item#214 $29.95 

This collection of time-saving screen and menu utilities can 
increase the power and speed of interactive BASIC programs, 
and simplify the coding required for application screens. 


¢Turbo Pascal for BASIC Programmers 

Item #206A $14.95 

Learn why Pascal is easier to write, read, test and debug than 
BASIC. You'll find a library of useful programs, appendices 
including the ASCII character codes, a Turbo Pascal dictionary, 
and other helpful aides. A disk is also available. 


*Companion disk Item #206B $29.95 


‘PC Tools Item#216 $39.95 
PC Tools provides a complete 
collection of RAM resident system utility programs 
for IBM PC's and compatibles. It includes many of 
the same features found in DOS, along with 
additional features for recovering accidently deleted 
files, viewing and editing file contents, and more. 


-DS Backup Item#215 $69.95 
This high-performance program has all the features 
you need to make your backup routine fast and easy. 
The package contains a disk and manual and is not 
copy protected. 
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Micro/Systems Journal 
Library 


Toolbooks from 
Dr. Dobb's 


«Dr. Dobb's Toolbook of 
68000 Programming 
Item #040 $29.95 
This Toolbook contains the bes 
68000 articles reprinted from Dr. 
Dobb's Journal, along with new 
68000 programming tools, 
applications and examples. Softwa 
in the book is also available on dis] 
with full source code. 
68000 Toolbook with software on 
disk Item #041 $49.95 
Formats: CP/M 8", Osborne, Macintosh, Amiga 
Atari 520st, MS-DOS 


‘Dr. Dobb's Toolbook of C Item #005 $29.95 

This authoritative reference contains over 700 pages of materi; 
by C experts, including the best C articles from Dr. Dobb’s 
Journal. You'll find hundreds of pages of valuable C source cox 
including a complete compiler, an assembler, and text 
processing utilities, all also available on disk. 


*Dr. Dobb's Toolbook of Forth Item #030 $22.95 
This collection of useful Forth programs and tutorials contains 
expanded and revised versions of Dr. Dobb’ s best Forth article 
along with new material. The screens in the book are also 
available on disk with full source code. 


Toolbook of Forth with software on disk 

Item #031 $39.95 

Formats: MS/PC-DOS, Apple II, Macintosh, or CP/M. For 
CP/M disks specify Osborne or 8" SS/SD. 


MS-DOS Utilities & Books 


‘Taming MS-DOS Item #060 $19.95 

This advanced user's guide will show you how to 
enhance and extend the power of MS-DOS so that 
you can work more efficiently, you'll find nearly 

50 batch files and ready-to-use programs with source 
code so you can customize DOS to fit your needs. 


*TallScreen Item#217 $49.95 

This resident screen and keyboard enhancement utility 
extend the capabilities of DOS to bring you more 
flexibility and power. You can scroll the screen to see 
previous DOS output, store multiple DOS commands, 
use a full screen editor at the DOS command line, 

and more. 
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Turbo Pascal Books & Software Libraries 


‘Turbo-Advantage Item #070 $49.95 


Save time developing your Turbo Pascal programs with 


this library of 220 routines for Turbo Pascal. Arithmetic “Turbo Complex Item#071 $89.95 

operations, bit manipulations, check routines, data This library of Turbo Pascal procedures and functions allows 

compression, menu functions, MS-DOS support, and you to work easily with complex numbers, vectors and 

statistical procedures are just a few of the routines included. matrices. Some Turbo Complex routines are most effectively 

The package contains source code and documentation. used with Turbo Advantage routines (above). The package 

For MS-DOS systems. includes full source code and documentation. For MS-DOS 
systems. 


Turbo Display Item #072 $69.95 
Turbo Displayis a screen generator for Turbo Pascal. You'll «Stat Toolbox for Turbo Pascal Item #050 $69.95 


a Fnsoacas ES me ane along se . rey cama The Stat Toolbox contains two complete packages: a Turbo 
srocedures and functions. The package includes full source Pascal library of statisical routines including statistical 


code and documentation. Turbo Display is most effectively distribution functions, random number generation, basic 


ised with the Turbo Advantage routines, above (item #070). _— sb . : er i 
Zor MS-DOS systems. descriptive statistics, and more; and fully-functioning statis 


tical programs with two data management systems. Source 
code is included. 


Dbase Ill Programming Guides 


Dbase Ill Advanced Programming , , 
Item #204 $22.95 eAdvanced Programming Guide to 


Dbasell Item#Z213 $28.95 


This is the most in-depth book on Dbase 
available, containing over 600 pages of 
information on debugging techiniques, 
subroutines, structured programming, 
terminal codes, reserved words, and 
more. 


Learn how to speed up Dbase programs, and 
how programs written in assembly, BASIC, 
Pascal or C can be adapted to run with Dbase 
applications. This book will show you how 
to write efficient code, how a particular coding 
technique works, and when to use it. 


To Order: 


» order any of Dr. Dobb's 
MicroSystems Journal 
oducts, return the order 
‘m, or 


Call Toll-Free 
1-800-528-6050 
EXT 4001 
d refer to product item 
umber, title, and disk 
"mat. 


Order Form 


Yes! Please send me the following book(s), software with payment by: 
DWisa ©) Mastercard (I American Express CI Check 
Disk Format Unit Price Total Price 


or customer Sub-Total 
2rvice questions: Name annone 
Call M&T Fy pene street address, not P.O. Box) Total Order 
Publishing, Inc. CN State Zip "Calif. residents must add 
(41 pli a Card# Exp, Det applicable sales tax to total 


Signature **Add $2.25 per item shipping 
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Time and Task Management, by 
Timothy Berry works with your dBASE Ill 
package to let you orchestrate the tasks, time 
and budgets of you and your staff. The system 
contains dozens of programs, and includes 
source code so you can customize programs 
to fit YOUR needs. You'll find: 


Special Input Program that allows 
data entry at any time, by different users 
on different computers, without requiring 
dBASE Ili for each one 


¢ Data files, some with sample values, 
some empty for your own input 


Program files, all easy to read and 
modify 


* Report files, some reports are 
included, along with instructions to write 
your own 


Format files, to set the format for 
data entry and editing 


¢ Index files, for fast access to other 
files 


96 


Die W Digital: Ines. xcnunwnnsa cosine 34 
Digital DECBIONS: sarees ceeswowasetaware 63 
Digital DeCiSIOIS po.0:0:usisierecovivernuncoreenereieneierese 83 
Digital Research Computers .......-.-++065 11 


Advertiser Index 


ERCCHPES NGS. iss: osésexassvavieis sea sonsranicscenaraca acaue 26 
FRRUMIE cam aanue mem premiere se ateex 19 
Fulcrum Computer Prod. «1.0.0... e ee ene 15 
Gaty. Van Cotts 5: tase uteiicoeaeasas 92 
Ginpel acca sin ncenennwu tanner sianneen 56 
CHE -onsscnaecesaewcnnnieesecewen 60 
Hawkeye: Grafix Ines: siticiecscrcee octets tia eran 92 
Integrand Research Corp. .... 2.222 -+eee eee 63 
Intercontinental Microsystems .........++05 35 
Intercontinental Microsystems ........-.--+ 37 
Intercontinental Microsystems ..........005 39 
L JF TORRONE aaieinccye sa: cere encemmneaiee 85 
Laboratory Microsystems, Inc. .......-2++65 77 
Lodden Technology Bid os:cca ccaacs taceaes 53 
MISCIC BOOKS «50:06 650.0 -icisaearenednextrtanexeaye 94-95 
Macrotech International ..........+-20-6+- C-2 
Martian Technology cis isivs sisievs sereesaawes 88 
PAGO ace scivasrsvarorpravernieits pocn etnies sreecanenave $2 


Micro Methods, Inc: ..ccaecicceccens see ne 92 
Micro Supply Organization ...........-+ 48-49 
Microcomputer System Consultants ......... 87 
MICFOMINE ....00cccdeeerdeverernereeee 79 
MUCK: coracsniicaasase txesynmavnwieeneieecousevecea 83 
Wits Software 020.05 ose ees eae eR aes 2 
Mycroft Labs: ccs ciicacciiaweincaws eve 91 


Time and 
Task 
Management 
with 
dBASE III ™ 
by Tim Berry 


Night: Owl 4:5. ais. dis @aieiaveleleeiciaieis cae Saiergeis 47 
PerfOrinies Un Chace ares varerasacovancite avenecaserersnexnarsca 23 
Periscope Co., Inc. 0.2 enc eceeeecceeceees 93 
Personal Business Solutions .........-..++++ 45 
Poor Person Software .......ccsecsecceens 61 
Peete A ONC crva sre ees a cerevnaticatetwaies emacerern ie 77 
Professional Software Programmer's Assn. . . . . .92 
RGZL MICTOSENVICES: 5 atest eens eure 20 
Rational Systems: resiac cise cacsusrscoresrerese-o6e OP 
SEO) sa satecanscernimieis scinecetmrersiecneenaiege aoges 30-31 
SG Digital: sicaiwie te s.s0e wisiaretesazeiote aie state cheer 45 
ee Oe a Ce a ee ner ee en tr C-4 
Servo Computer 6:06 siesisieiecere acces eee ee 72 
SLR SPRGNE are occ ceewemiresmmmecenesisreaiace 73 
Slicer Computer .......0cccccscevrerecns 19 
SMUG *sy aaiaieene aes ur eens 92 
Sparks MICK cis siareserarearevers:aceoroie areinsereleare 92 
Sunny Hill Software .........cscecececenne 61 
Tee Kay 24 siar sari rane ee atasciviewiers 20 
Weletele:.icssacenssacenanerermaversvarenacave arora grereswsine C-3 


Thinker’s Apprentice ........--eeeeeeeeee 21 
TIPZ, ois.ere-s, 0.0 arswislois os VES NS asiaiw esate sie 32 
Jurbo-Tech Report. sia tive severe ciate as 33 
Viasyn/CompuPro .......-0e eee eeeeeeeee 1 
Western Ware ics. sav te iawienisnsiyorenrs ae oie TT 


For only $49.95, Time and Task 
Management includes source code anda 
manual with complete documentation. You'll 
spend less time keeping better track 
of your work. 


Time and Task Management works 
with dBASE Ill and your IBM or compatible. 


TO ORDER: 

CALL TOLL FREE 800-533-4372 
(Mon-Fri, 8-5 Pacific Time) 

In Calif: 800-356-2002 

Or, return your order and payment to: 
M&T Publishing, 

501 Galveston Dr., 

Redwood City, CA 94063 
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One Strong Link 
Can Strengthen Your 
Whole System 


TurboNET® is Teletek’s new local 
area network that permits reliable 
high speed data transfers among com- 
puters of differing bus architectures. 
TurboNET is designed to be used in 
networks consisting of multiple S-100 
based and PC based systems. It will 
allow up to 4000 users, including 

up to 255 IBM PCs or compatibles, 
to share a single network and all 
attached peripherals. The network 
can be organized in any number of 
different ways mixing Teletek’s 8 and 
16-bit multiuser systems and PCs in 
any combination. 


Teletek’s Networking Family consists of: 


TurboNET PC: 

IBM-PC Network Interface Board 
Teletek’s TurboNET PC board offers 
IBM-PC Compatibility, CSMA industry 
standard protocols, 2 megabits/sec 
network speed, on-board CPU and 
communications management firm- 
ware, and media independence. 


TurboNET S-100: 
S-100 Network Interface Board 
Teletek’s TurboNET S-100 board offers 
IEEE 696 Compatibility, CSMA indus- 
try standard protocols, 2 megabits/sec 
network speed, on-board CPU and 
communications management firm- 
ware, and media independence. 


TELETEK 


4600 Pell Drive, Sacramento, CA 95838 
(916) 920-4600 Telex #4991834 Answer back — Teletek 


The benefits are obvious: The cost 
savings of shared peripherals, almost 
unlimited system expansion capabil- 
ity, and the use of existing PC work- 
stations with the ability to run the 
myriad of application software written 
for MS-DOS and PC-DOS. This 
coupled with Teletek’s 8 and 16-bit 
multiuser systems running application 
software written for CP/M and MP/M 
allows the system the ability to access 
almost any software library. 


For more information on Teletek’s 
TurboNET S-100 and TurboNET PC 
boards or on any of our full line of 
S-100 products, please call our Sales 
Department at 916-920-4600. 


© 1986 Teletek 


SCALE THE HEIGHTS 
OF PRODUCTIVITY sf 
Sure, you've proven that ifyour hands 
a computer is aproductive tool. But if 
you haven't teamed up. with a 
SemiDisk you have heights yet to 
climb! 


IT’S NO MERE RAMDISK 


SemiDisk has been leading the way for 
Disk Emulators since their inception. 
If you've seen RAMdisks you know 
what it’s like to load programs in an 


SEMIDISK 


SemiDisk Systems, Inc. 


P.O: Box GG, Beaverton, Oregon 97075 


503-626-3104 


instant, and read or write files without 
delay. Unlike alternatives, the 
SemiDisk offers up to 8 megabytes of 
instant-access storage while leaving 
your computer’s main memory free 
for what it does best - computing! 
KEEP A GRIP ON DATA 

Go ahead, turn off your computer. 
Take a vacation. With the battery 
backup option, your valuable data will 
be there in the morning even if you 
aren't. You'll sleep better knowing not 
even a 5 hour blackout will sabotage 
your files. 


NEW LOWER SEMIDISK 


PRICES THAT WON’T 
SNOW YOU UNDER 

512K 2Mbyte 
IBM PC, XT, AT $495 $995 
Epson QX-10 $595 $995 
S-100,SemiDisk II $799 $1295 
S-100, SemiDisk I $595 — 
TRS-80 If, 12, 16 $695 $1295 
Battery 
Backup Unit $130 $130 


Software drivers available for CP/M 80, 
MS-DOS, ZDOS, TurboDOS, and VALDOCS 2. 


Gall 503-646-5510 for CBBS/NW, and 503-649-8327 for CBBS/Aloha, all SemiDisk equipped computer bulletin boards, (300/1200/2400 baud) SemiDisk, SemiSpool trademarks of SemiDisk Systems 


